@iola_adm/iola-cli 0.1.8 → 0.1.10

package/README.md

@@ -62,6 +62,7 @@ npx -y @iola_adm/iola-cli ai setup ollama
 
 ```bash
 npx -y @iola_adm/iola-cli help
+npx -y @iola_adm/iola-cli init --yes
 ```
 
 Глобальная установка:
@@ -69,6 +70,7 @@ npx -y @iola_adm/iola-cli help
 ```bash
 npm install -g @iola_adm/iola-cli
 iola help
+iola init
 ```
 
 ## Команды
@@ -76,6 +78,19 @@ iola help
 ```bash
 iola banner
 iola agent
+iola chat
+iola init
+iola doctor
+iola config get
+iola config set api.baseUrl https://apiiola.yasg.ru/api/v1
+iola config reset
+iola update
+iola version --check
+iola ask "Найди школу 29"
+iola data schools --limit 10
+iola data kindergartens --search "29"
+iola data schools --where address=Петрова --columns name,address,phone
+iola data schools --format csv
 iola ai doctor
 iola ai setup ollama
 iola ai ask "Какие школы есть на улице Петрова?"
@@ -87,6 +102,7 @@ iola ai setup openrouter --model openai/gpt-4.1-mini
 iola health
 iola layers
 iola schools --limit 10
+iola schools --format csv
 iola schools get --inn 1215067180
 iola kindergartens --search "29"
 iola kindergartens get --inn 1215077421 --json
@@ -96,7 +112,8 @@ iola setup codex
 ```
 
 По умолчанию команды выводят компактную таблицу. Для полного ответа API
-используйте `--json`.
+используйте `--json` или `--format json`. Для выгрузки используйте
+`--format csv`.
 
 ## Интерактивный режим
 
@@ -109,7 +126,10 @@ iola agent
 ```text
 /help
 /health
+/doctor
+/config get
 /layers
+/data schools --limit 10
 /schools --limit 10
 /schools get --inn 1215067180
 /kindergartens --search 29
@@ -126,10 +146,13 @@ iola agent
 /config
 /history
 /clear
+/update
+/init
 /exit
 ```
 
 Обычный текст без `/` в `iola agent` отправляется в настроенный AI-провайдер.
+`iola chat` запускает тот же интерактивный режим.
 
 ## AI-запросы
 
@@ -138,6 +161,7 @@ iola agent
 ```bash
 iola ai setup ollama
 iola ai ask "Какие школы есть на улице Петрова?"
+iola ask "Какие школы есть на улице Петрова?"
 ```
 
 OpenAI:
@@ -166,6 +190,10 @@ iola ai context "улица Петрова"
 
 Поиск контекста учитывает номера учреждений, ИНН и улицы.
 
+AI-ответ строится по контексту из публичного API. Ассистент получает краткий
+список источников контекста и должен указывать слой, название и ИНН, если
+отвечает по конкретным организациям.
+
 Ключи OpenAI/OpenRouter сохраняются локально на компьютере пользователя:
 
 ```text
@@ -185,14 +213,14 @@ iola ai key delete openai
 `OPENROUTER_API_KEY`) и сохранен локальный ключ, CLI использует переменную
 окружения как более приоритетную.
 
-AI-ответ строится по контексту из публичного API. Если данных в контексте
-недостаточно, ассистент должен сообщить об этом, а не выдумывать сведения.
+Если данных в контексте недостаточно, ассистент должен сообщить об этом, а не
+выдумывать сведения.
 
 ## Назначение
 
 CLI дает прямой терминальный доступ к открытым данным городского округа,
-командам подключения MCP/skill, AI-запросам через Ollama/OpenAI/OpenRouter и
-интерактивному агентному режиму.
+командам подключения MCP/skill, AI-запросам через Ollama/OpenAI/OpenRouter,
+интерактивному агентному режиму, экспорту данных и проверке обновлений.
 
 ## Переменные окружения
 
@@ -200,3 +228,12 @@ CLI дает прямой терминальный доступ к открыт
 IOLA_API_BASE_URL=https://apiiola.yasg.ru/api/v1
 IOLA_MCP_BASE_URL=https://apiiola.yasg.ru
 ```
+
+Переменные окружения имеют приоритет над локальной конфигурацией. Локальные
+endpoints можно настроить так:
+
+```bash
+iola config set api.baseUrl https://apiiola.yasg.ru/api/v1
+iola config set api.mcpBaseUrl https://apiiola.yasg.ru
+iola config get
+```

package/package.json

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

package/src/cli.js

@@ -11,12 +11,26 @@ const CONFIG_DIR = path.join(os.homedir(), ".iola");
 const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
 const SECRETS_FILE = path.join(CONFIG_DIR, "secrets.json");
 const DEFAULT_AI_CONFIG = {
+  api: {
+    baseUrl: "https://apiiola.yasg.ru/api/v1",
+    mcpBaseUrl: "https://apiiola.yasg.ru",
+  },
   ai: {
     provider: "ollama",
     model: "llama3.2:1b",
     baseUrl: "http://127.0.0.1:11434",
   },
 };
+const DATASETS = {
+  schools: {
+    title: "Школы",
+    endpoint: "schools",
+  },
+  kindergartens: {
+    title: "Детские сады",
+    endpoint: "kindergartens",
+  },
+};
 const BANNER = `\x1b[38;5;45m┌────────────────────────────────────────────────────────────────────────────┐
 │\x1b[38;5;51m   ____ _     ___      ____  ____   ___  _____ _  _______                  \x1b[38;5;45m│
 │\x1b[38;5;51m  / ___| |   |_ _|    |  _ \\|  _ \\ / _ \\| ____| |/ /_   _|                 \x1b[38;5;45m│
@@ -34,11 +48,18 @@ const BANNER = `\x1b[38;5;45m┌────────────────
 const COMMANDS = new Map([
   ["help", showHelp],
   ["version", showVersion],
+  ["update", checkUpdate],
+  ["doctor", doctor],
+  ["config", handleConfig],
   ["banner", showBanner],
   ["agent", startAgent],
+  ["chat", startAgent],
+  ["ask", aiAsk],
   ["ai", handleAi],
+  ["init", initCli],
   ["health", checkHealth],
   ["layers", listLayers],
+  ["data", handleData],
   ["schools", listSchools],
   ["kindergartens", listKindergartens],
   ["search", searchAll],
@@ -64,6 +85,16 @@ async function showHelp() {
 Usage:
   iola banner
   iola agent
+  iola chat
+  iola init
+  iola doctor
+  iola config get
+  iola config set api.baseUrl URL
+  iola config set api.mcpBaseUrl URL
+  iola config reset
+  iola update
+  iola ask TEXT
+  iola data LAYER [--limit 10] [--search TEXT] [--where FIELD=VALUE] [--columns a,b,c] [--format table|json|csv]
   iola ai ask TEXT [--provider ollama|openai|openrouter] [--model MODEL]
   iola ai context TEXT [--json]
   iola ai key set openai
@@ -75,11 +106,11 @@ Usage:
   iola ai setup ollama [--yes] [--model MODEL]
   iola health [--json]
   iola layers [--json]
-  iola schools [--limit 10] [--search TEXT] [--json]
+  iola schools [--limit 10] [--search TEXT] [--where FIELD=VALUE] [--columns a,b,c] [--format table|json|csv]
   iola schools get --inn INN [--json]
-  iola kindergartens [--limit 10] [--search TEXT] [--json]
+  iola kindergartens [--limit 10] [--search TEXT] [--where FIELD=VALUE] [--columns a,b,c] [--format table|json|csv]
   iola kindergartens get --inn INN [--json]
-  iola search TEXT [--limit 5] [--json]
+  iola search TEXT [--limit 5] [--format table|json|csv]
   iola mcp-info [--json]
   iola setup codex
   iola version
@@ -160,7 +191,17 @@ async function handleAgentLine(line, state) {
   }
 
   if (command === "config") {
-    await printAiConfig();
+    await handleConfig(args.length > 0 ? args : ["get"]);
+    return false;
+  }
+
+  if (command === "doctor") {
+    await doctor(args);
+    return false;
+  }
+
+  if (command === "cfg" || command === "settings") {
+    await handleConfig(args);
     return false;
   }
 
@@ -194,6 +235,16 @@ async function handleAgentLine(line, state) {
     return false;
   }
 
+  if (command === "update") {
+    await checkUpdate(args);
+    return false;
+  }
+
+  if (command === "init") {
+    await initCli(args);
+    return false;
+  }
+
   if (command === "ai") {
     await handleAi(args);
     return false;
@@ -201,7 +252,10 @@ async function handleAgentLine(line, state) {
 
   const mapped = {
     health: ["health", args],
+    doctor: ["doctor", args],
+    config: ["config", args],
     layers: ["layers", args],
+    data: ["data", args],
     schools: ["schools", args],
     kindergartens: ["kindergartens", args],
     search: ["search", args],
@@ -224,7 +278,11 @@ function printAgentHelp() {
   console.log(`Slash-команды:
   /help
   /health
+  /doctor
+  /config get
+  /config set api.baseUrl URL
   /layers
+  /data schools --limit 10
   /schools --limit 10
   /schools get --inn 1215067180
   /kindergartens --search 29
@@ -244,6 +302,8 @@ function printAgentHelp() {
   /history
   /clear
   /banner
+  /update
+  /init
   /exit
 
 Обычный текст без slash-команды отправляется в настроенный AI-провайдер.`);
@@ -282,14 +342,48 @@ function showBanner() {
   console.log("открытые данные • MCP • локальный AI");
 }
 
-async function showVersion() {
+async function showVersion(args = []) {
+  const options = parseOptions(args);
   const packageJson = await import("../package.json", { with: { type: "json" } });
   console.log(packageJson.default.version);
+
+  if (options.check) {
+    await checkUpdate([]);
+  }
+}
+
+async function checkUpdate() {
+  const packageJson = await import("../package.json", { with: { type: "json" } });
+  const current = packageJson.default.version;
+  const latest = await getLatestNpmVersion(packageJson.default.name);
+
+  if (!latest) {
+    console.log("Не удалось проверить npm-версию.");
+    return;
+  }
+
+  const comparison = compareVersions(latest, current);
+
+  if (comparison > 0) {
+    console.log(`Доступна новая версия: ${latest}`);
+    console.log("Обновление:");
+    console.log(`  npm install -g ${packageJson.default.name}@latest`);
+    console.log("Или запуск без установки:");
+    console.log(`  npx -y ${packageJson.default.name}@latest help`);
+    return;
+  }
+
+  if (comparison < 0) {
+    console.log(`Локальная версия ${current} новее опубликованной npm latest ${latest}.`);
+    return;
+  }
+
+  console.log(`Установлена актуальная версия: ${current}`);
 }
 
 async function checkHealth(args) {
   const options = parseOptions(args);
-  const health = await fetchJson(`${MCP_BASE_URL}/mcp-health`);
+  const health = await fetchJson(`${await getMcpBaseUrl()}/mcp-health`);
 
   if (options.json) {
     printJson(health);
@@ -304,6 +398,127 @@ async function checkHealth(args) {
   });
 }
 
+async function doctor(args = []) {
+  const options = parseOptions(args);
+  const packageJson = await import("../package.json", { with: { type: "json" } });
+  const config = await loadConfig();
+  const secrets = await loadSecrets();
+  const diagnostics = await getLocalDiagnostics();
+  const latest = await getLatestNpmVersion(packageJson.default.name);
+  const apiBaseUrl = await getApiBaseUrl();
+  const mcpBaseUrl = await getMcpBaseUrl();
+  const report = {
+    cli: {
+      version: packageJson.default.version,
+      npmLatest: latest || "-",
+      update: getUpdateStatus(packageJson.default.version, latest),
+    },
+    api: {
+      baseUrl: apiBaseUrl,
+      mcpBaseUrl,
+      health: await probeEndpoint(`${mcpBaseUrl}/mcp-health`),
+    },
+    ai: {
+      provider: config.ai.provider,
+      model: config.ai.model,
+      modelAvailable: await checkConfiguredModel(config),
+      openaiKey: process.env.OPENAI_API_KEY ? "env" : secrets.openai?.apiKey ? "local" : "missing",
+      openrouterKey: process.env.OPENROUTER_API_KEY ? "env" : secrets.openrouter?.apiKey ? "local" : "missing",
+      ollama: diagnostics.ollama.installed ? diagnostics.ollama.version : "not-installed",
+    },
+    system: diagnostics,
+  };
+
+  if (options.json) {
+    printJson(report);
+    return;
+  }
+
+  console.log("CLI");
+  printKeyValue(report.cli);
+  console.log("");
+  console.log("API/MCP");
+  printKeyValue(report.api);
+  console.log("");
+  console.log("AI");
+  printKeyValue(report.ai);
+  console.log("");
+  printDiagnostics(diagnostics, recommendOllamaModel(diagnostics));
+}
+
+function getUpdateStatus(current, latest) {
+  if (!latest) {
+    return "unknown";
+  }
+
+  const comparison = compareVersions(latest, current);
+
+  if (comparison > 0) {
+    return "available";
+  }
+
+  if (comparison < 0) {
+    return "local-newer";
+  }
+
+  return "ok";
+}
+
+async function checkConfiguredModel(config) {
+  if (config.ai.provider !== "ollama") {
+    return "external-api";
+  }
+
+  try {
+    const response = await fetch(`${config.ai.baseUrl || "http://127.0.0.1:11434"}/api/tags`);
+
+    if (!response.ok) {
+      return "unknown";
+    }
+
+    const payload = await response.json();
+    const models = payload.models || [];
+    return models.some((model) => model.name === config.ai.model) ? "installed" : "missing";
+  } catch {
+    return "ollama-unavailable";
+  }
+}
+
+async function initCli(args = []) {
+  const options = parseOptions(args);
+
+  showBanner();
+  console.log("Проверка окружения");
+  printKeyValue({
+    node: process.version,
+    npm: await getCommandVersion("npm", ["--version"]),
+    api: await probeEndpoint(`${await getMcpBaseUrl()}/mcp-health`),
+    mcp: await getMcpBaseUrl(),
+  });
+  console.log("");
+
+  await aiDoctor(options.json ? ["--json"] : []);
+
+  if (!process.stdin.isTTY || options.yes) {
+    console.log("");
+    console.log("Для настройки AI используйте:");
+    console.log("  iola ai setup ollama");
+    console.log("  iola ai key set openai");
+    console.log("  iola ai setup openai --model gpt-4.1-mini");
+    return;
+  }
+
+  console.log("");
+  const configureAi = await confirm("Настроить AI-провайдер сейчас? [Y/n] ");
+
+  if (configureAi) {
+    await aiSetup([]);
+  }
+
+  console.log("");
+  await checkUpdate();
+}
+
 async function handleAi(args) {
   const [subcommand = "help", ...rest] = args;
 
@@ -354,6 +569,47 @@ async function handleAi(args) {
   throw new Error(`Unknown AI command: ${subcommand}\nRun "iola ai help" to see available commands.`);
 }
 
+async function handleConfig(args) {
+  const [action = "get", key, ...rest] = args;
+
+  if (action === "get") {
+    const config = await loadConfig();
+    if (key) {
+      console.log(getConfigValue(config, key) ?? "-");
+      return;
+    }
+    printJson({
+      file: CONFIG_FILE,
+      config,
+      effective: {
+        apiBaseUrl: await getApiBaseUrl(),
+        mcpBaseUrl: await getMcpBaseUrl(),
+      },
+    });
+    return;
+  }
+
+  if (action === "set") {
+    const value = rest.join(" ").trim();
+    if (!key || !value) {
+      throw new Error("Пример: iola config set api.baseUrl https://apiiola.yasg.ru/api/v1");
+    }
+    const config = await loadConfig();
+    setConfigValue(config, key, value);
+    await saveConfig(config);
+    console.log(`Сохранено: ${key} = ${value}`);
+    return;
+  }
+
+  if (action === "reset") {
+    await writeConfig(DEFAULT_AI_CONFIG);
+    console.log(`Конфигурация сброшена: ${CONFIG_FILE}`);
+    return;
+  }
+
+  throw new Error("Команды config: get, set, reset.");
+}
+
 async function aiDoctor(args) {
   const options = parseOptions(args);
   const diagnostics = await getLocalDiagnostics();
@@ -393,7 +649,8 @@ async function aiSetup(args) {
       },
     });
     console.log(`AI-профиль ${provider} сохранен в ${CONFIG_FILE}`);
-    console.log(`Ключ задайте через переменную окружения ${provider === "openai" ? "OPENAI_API_KEY" : "OPENROUTER_API_KEY"}.`);
+    console.log(`Ключ сохраните командой: iola ai key set ${provider}`);
+    console.log(`Также можно использовать переменную окружения ${provider === "openai" ? "OPENAI_API_KEY" : "OPENROUTER_API_KEY"}.`);
     return;
   }
 
@@ -618,10 +875,12 @@ async function aiAsk(args, context = {}) {
 }
 
 async function buildDataContext(question) {
+  const apiBaseUrl = await getApiBaseUrl();
+  const mcpBaseUrl = await getMcpBaseUrl();
   const [layers, schools, kindergartens] = await Promise.all([
-    fetchJson(`${MCP_BASE_URL}/mcp-version`),
-    fetchJson(`${API_BASE_URL}/schools?limit=100&offset=0`),
-    fetchJson(`${API_BASE_URL}/kindergartens?limit=100&offset=0`),
+    fetchJson(`${mcpBaseUrl}/mcp-version`),
+    fetchJson(`${apiBaseUrl}/schools?limit=100&offset=0`),
+    fetchJson(`${apiBaseUrl}/kindergartens?limit=100&offset=0`),
   ]);
   const queryTerms = extractSearchTerms(question);
   const patterns = extractStructuredPatterns(question);
@@ -738,12 +997,14 @@ function scoreItem(item, terms, patterns, layer) {
 }
 
 function buildAiMessages(question, dataContext, history) {
+  const sourceLines = buildSourceLines(dataContext);
   const system = [
     "Ты терминальный AI-ассистент CLI-проекта Йошкар-Олы.",
     "Отвечай на русском языке.",
     "Используй только данные из переданного контекста.",
     "Если в контексте нет нужных сведений, прямо напиши, что данных недостаточно.",
     "Не выдумывай адреса, телефоны, лицензии и руководителей.",
+    "Если отвечаешь по конкретным организациям, укажи источник в конце: слой, название и ИНН.",
     "Отвечай кратко и по делу.",
   ].join(" ");
   const contextText = JSON.stringify(dataContext, null, 2);
@@ -754,11 +1015,26 @@ function buildAiMessages(question, dataContext, history) {
     ...recentHistory,
     {
       role: "user",
-      content: `Контекст открытых данных городского округа "Город Йошкар-Ола":\n${contextText}\n\nВопрос пользователя: ${question}`,
+      content: `Контекст открытых данных городского округа "Город Йошкар-Ола":\n${contextText}\n\nКраткие источники контекста:\n${sourceLines}\n\nВопрос пользователя: ${question}`,
     },
   ];
 }
 
+function buildSourceLines(dataContext) {
+  const rows = [
+    ...dataContext.schools.map((item) => ({ layer: "schools", ...item })),
+    ...dataContext.kindergartens.map((item) => ({ layer: "kindergartens", ...item })),
+  ];
+
+  if (rows.length === 0) {
+    return "Совпавших организаций нет.";
+  }
+
+  return rows
+    .map((item) => `- ${item.layer}: ${item.name || "-"}; ИНН ${item.inn || "-"}; адрес ${item.address || "-"}`)
+    .join("\n");
+}
+
 async function callAiProvider(config, messages) {
   if (config.provider === "ollama") {
     return callOllama(config, messages);
@@ -802,7 +1078,7 @@ async function callOllama(config, messages) {
 
 async function callOpenAiCompatible(config, messages, apiKey, providerName) {
   if (!apiKey) {
-    throw new Error(`${providerName} API key не найден. Задайте ${providerName === "OpenAI" ? "OPENAI_API_KEY" : "OPENROUTER_API_KEY"}.`);
+    throw new Error(`${providerName} API key не найден. Выполните iola ai key set ${providerName === "OpenAI" ? "openai" : "openrouter"} или задайте ${providerName === "OpenAI" ? "OPENAI_API_KEY" : "OPENROUTER_API_KEY"}.`);
   }
 
   const response = await fetch(`${config.baseUrl}/chat/completions`, {
@@ -844,7 +1120,7 @@ async function getApiKey(provider) {
 
 async function listLayers(args) {
   const options = parseOptions(args);
-  const info = await fetchJson(`${MCP_BASE_URL}/mcp-version`);
+  const info = await fetchJson(`${await getMcpBaseUrl()}/mcp-version`);
 
   if (options.json) {
     printJson(info.data_layers);
@@ -861,7 +1137,7 @@ async function listLayers(args) {
 
 async function showMcpInfo(args) {
   const options = parseOptions(args);
-  const info = await fetchJson(`${MCP_BASE_URL}/mcp-version`);
+  const info = await fetchJson(`${await getMcpBaseUrl()}/mcp-version`);
 
   if (options.json) {
     printJson(info);
@@ -886,6 +1162,28 @@ async function listKindergartens(args) {
   await listDataset("kindergartens", args);
 }
 
+async function handleData(args) {
+  const [dataset, ...rest] = args;
+
+  if (!dataset) {
+    console.log("Доступные слои:");
+    printTable(Object.entries(DATASETS).map(([id, value]) => ({ id, name: value.title })), [
+      ["id", "ID"],
+      ["name", "Название"],
+    ]);
+    console.log("");
+    console.log("Пример:");
+    console.log("  iola data schools --limit 10");
+    return;
+  }
+
+  if (!DATASETS[dataset]) {
+    throw new Error(`Неизвестный слой: ${dataset}. Доступно: ${Object.keys(DATASETS).join(", ")}`);
+  }
+
+  await listDataset(dataset, rest);
+}
+
 async function listDataset(dataset, args) {
   const options = parseOptions(args);
 
@@ -898,17 +1196,24 @@ async function listDataset(dataset, args) {
   params.set("limit", options.limit || "20");
   params.set("offset", options.offset || "0");
 
-  const data = await fetchJson(`${API_BASE_URL}/${dataset}?${params}`);
+  const data = await fetchJson(`${await getApiBaseUrl()}/${DATASETS[dataset].endpoint}?${params}`);
   const items = normalizeItems(data);
-  const filtered = options.search ? filterItems(items, options.search) : items;
+  const filtered = applyDatasetFilters(items, options);
   const limited = filtered.slice(0, Number(options.limit || 20));
+  const summarized = limited.map(selectPublicSummary);
+  const projected = projectColumns(summarized, options.columns);
 
-  if (options.json) {
-    printJson(limited);
+  if (options.json || options.format === "json") {
+    printJson(projected);
     return;
   }
 
-  printDatasetTable(limited);
+  if (options.format === "csv") {
+    printCsv(projected);
+    return;
+  }
+
+  printDatasetTable(projected, options.columns);
 }
 
 async function getDatasetItem(dataset, options) {
@@ -916,7 +1221,7 @@ async function getDatasetItem(dataset, options) {
     throw new Error(`INN is required. Example: iola ${dataset} get --inn 1215067180`);
   }
 
-  const data = await fetchJson(`${API_BASE_URL}/${dataset}?limit=500&offset=0`);
+  const data = await fetchJson(`${await getApiBaseUrl()}/${DATASETS[dataset].endpoint}?limit=500&offset=0`);
   const item = normalizeItems(data).find((entry) => String(entry.inn) === String(options.inn));
 
   if (!item) {
@@ -940,26 +1245,34 @@ async function searchAll(args) {
   }
 
   const [schools, kindergartens] = await Promise.all([
-    fetchJson(`${API_BASE_URL}/schools?limit=100&offset=0`),
-    fetchJson(`${API_BASE_URL}/kindergartens?limit=100&offset=0`),
+    fetchJson(`${await getApiBaseUrl()}/schools?limit=100&offset=0`),
+    fetchJson(`${await getApiBaseUrl()}/kindergartens?limit=100&offset=0`),
   ]);
 
   const limit = Number(options.limit || 5);
   const result = {
-    schools: filterItems(normalizeItems(schools), query).slice(0, limit),
-    kindergartens: filterItems(normalizeItems(kindergartens), query).slice(0, limit),
+    schools: projectColumns(filterItems(normalizeItems(schools), query).slice(0, limit).map(selectPublicSummary), options.columns),
+    kindergartens: projectColumns(filterItems(normalizeItems(kindergartens), query).slice(0, limit).map(selectPublicSummary), options.columns),
   };
 
-  if (options.json) {
+  if (options.json || options.format === "json") {
     printJson(result);
     return;
   }
 
+  if (options.format === "csv") {
+    printCsv([
+      ...result.schools.map((item) => ({ layer: "schools", ...item })),
+      ...result.kindergartens.map((item) => ({ layer: "kindergartens", ...item })),
+    ]);
+    return;
+  }
+
   console.log("Школы");
-  printDatasetTable(result.schools);
+  printDatasetTable(result.schools, options.columns);
   console.log("");
   console.log("Детские сады");
-  printDatasetTable(result.kindergartens);
+  printDatasetTable(result.kindergartens, options.columns);
 }
 
 async function setupClient(args) {
@@ -981,7 +1294,9 @@ function parseOptions(args) {
     const arg = args[index];
     if (arg === "--json" || arg === "--yes") {
       result[arg.slice(2)] = true;
-    } else if (arg === "--limit" || arg === "--offset" || arg === "--search" || arg === "--inn" || arg === "--model" || arg === "--provider") {
+    } else if (arg === "--check") {
+      result.check = true;
+    } else if (arg === "--limit" || arg === "--offset" || arg === "--search" || arg === "--where" || arg === "--columns" || arg === "--inn" || arg === "--model" || arg === "--provider" || arg === "--format") {
       result[arg.slice(2)] = args[index + 1];
       index += 1;
     } else {
@@ -1031,6 +1346,42 @@ function filterItems(items, query) {
   return items.filter((item) => JSON.stringify(item).toLocaleLowerCase("ru-RU").includes(normalized));
 }
 
+function applyDatasetFilters(items, options) {
+  let result = options.search ? filterItems(items, options.search) : items;
+
+  if (options.where) {
+    const [field, ...valueParts] = String(options.where).split("=");
+    const value = valueParts.join("=").trim().toLocaleLowerCase("ru-RU");
+    const key = field.trim();
+
+    if (!key || !value) {
+      throw new Error('Фильтр --where должен быть в формате field=value. Пример: --where address=Петрова');
+    }
+
+    result = result.filter((item) => {
+      const summary = selectPublicSummary(item);
+      const raw = summary[key] ?? item[key];
+      return String(raw ?? "").toLocaleLowerCase("ru-RU").includes(value);
+    });
+  }
+
+  return result;
+}
+
+function projectColumns(rows, columnsValue) {
+  if (!columnsValue) {
+    return rows;
+  }
+
+  const columns = String(columnsValue).split(",").map((column) => column.trim()).filter(Boolean);
+
+  if (columns.length === 0) {
+    return rows;
+  }
+
+  return rows.map((row) => Object.fromEntries(columns.map((column) => [column, row[column] ?? ""])));
+}
+
 function normalizeItems(payload) {
   if (Array.isArray(payload)) {
     return payload;
@@ -1050,7 +1401,7 @@ function normalizeItems(payload) {
 function selectPublicSummary(item) {
   return {
     inn: item.inn,
-    name: item.fns_short_name || item.fns_full_name,
+    name: item.name || item.fns_short_name || item.fns_full_name,
     address: item.address || item.legal_address,
     phone: item.phone,
     email: item.email,
@@ -1134,6 +1485,66 @@ async function getOllamaVersion() {
   }
 }
 
+async function getCommandVersion(command, args) {
+  try {
+    const { stdout } = await runCommand(command, args);
+    return stdout.trim() || "installed";
+  } catch {
+    if (process.platform === "win32" && !command.endsWith(".cmd")) {
+      try {
+        const { stdout } = await runCommand(process.env.ComSpec || "cmd.exe", ["/d", "/s", "/c", `${command} ${args.join(" ")}`]);
+        return stdout.trim() || "installed";
+      } catch {
+        return "не найден";
+      }
+    }
+
+    return "не найден";
+  }
+}
+
+async function probeEndpoint(url) {
+  try {
+    const response = await fetch(url, { headers: { accept: "application/json" } });
+    return response.ok ? "доступен" : `${response.status} ${response.statusText}`;
+  } catch {
+    return "недоступен";
+  }
+}
+
+async function getLatestNpmVersion(packageName) {
+  try {
+    const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`, {
+      headers: { accept: "application/json" },
+    });
+
+    if (!response.ok) {
+      return null;
+    }
+
+    const payload = await response.json();
+    return payload.version || null;
+  } catch {
+    return null;
+  }
+}
+
+function compareVersions(left, right) {
+  const leftParts = String(left).split(".").map(Number);
+  const rightParts = String(right).split(".").map(Number);
+  const length = Math.max(leftParts.length, rightParts.length);
+
+  for (let index = 0; index < length; index += 1) {
+    const diff = (leftParts[index] || 0) - (rightParts[index] || 0);
+
+    if (diff !== 0) {
+      return diff > 0 ? 1 : -1;
+    }
+  }
+
+  return 0;
+}
+
 function recommendOllamaModel(diagnostics) {
   const ramGb = diagnostics.ramGb || 0;
   const vramGb = diagnostics.gpu.vramGb || 0;
@@ -1204,6 +1615,12 @@ async function confirm(question) {
 }
 
 async function saveConfig(value) {
+  const current = await loadConfig();
+  const merged = mergeConfig(current, value);
+  await writeConfig(merged);
+}
+
+async function writeConfig(value) {
   await mkdir(CONFIG_DIR, { recursive: true });
   await writeFile(CONFIG_FILE, `${JSON.stringify(value, null, 2)}\n`, "utf8");
 }
@@ -1221,6 +1638,10 @@ function mergeConfig(base, override) {
   return {
     ...base,
     ...override,
+    api: {
+      ...base.api,
+      ...(override.api || {}),
+    },
     ai: {
       ...base.ai,
       ...(override.ai || {}),
@@ -1228,6 +1649,40 @@ function mergeConfig(base, override) {
   };
 }
 
+async function getApiBaseUrl() {
+  if (process.env.IOLA_API_BASE_URL) {
+    return process.env.IOLA_API_BASE_URL;
+  }
+
+  const config = await loadConfig();
+  return config.api.baseUrl;
+}
+
+async function getMcpBaseUrl() {
+  if (process.env.IOLA_MCP_BASE_URL) {
+    return process.env.IOLA_MCP_BASE_URL;
+  }
+
+  const config = await loadConfig();
+  return config.api.mcpBaseUrl;
+}
+
+function getConfigValue(config, key) {
+  return key.split(".").reduce((value, part) => value?.[part], config);
+}
+
+function setConfigValue(config, key, value) {
+  const parts = key.split(".");
+  let current = config;
+
+  for (const part of parts.slice(0, -1)) {
+    current[part] = current[part] && typeof current[part] === "object" ? current[part] : {};
+    current = current[part];
+  }
+
+  current[parts.at(-1)] = value;
+}
+
 async function loadSecrets() {
   try {
     return JSON.parse(await readFile(SECRETS_FILE, "utf8"));
@@ -1337,7 +1792,35 @@ function printJson(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 
-function printDatasetTable(items) {
+function printCsv(rows) {
+  if (rows.length === 0) {
+    return;
+  }
+
+  const columns = [...new Set(rows.flatMap((row) => Object.keys(row)))];
+  console.log(columns.map(csvCell).join(","));
+
+  for (const row of rows) {
+    console.log(columns.map((column) => csvCell(row[column])).join(","));
+  }
+}
+
+function csvCell(value) {
+  const text = value == null ? "" : String(value);
+  return `"${text.replace(/"/g, "\"\"")}"`;
+}
+
+function printDatasetTable(items, columnsValue) {
+  if (columnsValue) {
+    const columns = String(columnsValue)
+      .split(",")
+      .map((column) => column.trim())
+      .filter(Boolean)
+      .map((column) => [column, column]);
+    printTable(items, columns);
+    return;
+  }
+
   printTable(items.map(selectPublicSummary), [
     ["inn", "ИНН"],
     ["name", "Название"],