@iola_adm/iola-cli 0.1.7 → 0.1.9

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,9 +78,17 @@ iola help
 ```bash
 iola banner
 iola agent
+iola chat
+iola init
+iola update
+iola version --check
+iola data schools --limit 10
+iola data kindergartens --search "29"
+iola data schools --format csv
 iola ai doctor
 iola ai setup ollama
 iola ai ask "Какие школы есть на улице Петрова?"
+iola ai context "школа 29"
 iola ai key set openai
 iola ai key status
 iola ai setup openai --model gpt-4.1-mini
@@ -86,6 +96,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
@@ -95,7 +106,8 @@ iola setup codex
 ```
 
 По умолчанию команды выводят компактную таблицу. Для полного ответа API
-используйте `--json`.
+используйте `--json` или `--format json`. Для выгрузки используйте
+`--format csv`.
 
 ## Интерактивный режим
 
@@ -109,21 +121,30 @@ iola agent
 /help
 /health
 /layers
+/data schools --limit 10
 /schools --limit 10
 /schools get --inn 1215067180
 /kindergartens --search 29
 /search лицей --limit 3
 /mcp-info
 /ai doctor
+/context школа 29
+/use ollama
+/use openai
+/key status
+/key set openai
 /model
 /provider
 /config
 /history
 /clear
+/update
+/init
 /exit
 ```
 
 Обычный текст без `/` в `iola agent` отправляется в настроенный AI-провайдер.
+`iola chat` запускает тот же интерактивный режим.
 
 ## AI-запросы
 
@@ -150,6 +171,20 @@ iola ai setup openrouter --model openai/gpt-4.1-mini
 iola ai ask "Покажи контакты лицея"
 ```
 
+Проверить, какие данные попадут в AI-контекст:
+
+```bash
+iola ai context "школа 29"
+iola ai context "1215067180" --json
+iola ai context "улица Петрова"
+```
+
+Поиск контекста учитывает номера учреждений, ИНН и улицы.
+
+AI-ответ строится по контексту из публичного API. Ассистент получает краткий
+список источников контекста и должен указывать слой, название и ИНН, если
+отвечает по конкретным организациям.
+
 Ключи OpenAI/OpenRouter сохраняются локально на компьютере пользователя:
 
 ```text
@@ -169,14 +204,14 @@ iola ai key delete openai
 `OPENROUTER_API_KEY`) и сохранен локальный ключ, CLI использует переменную
 окружения как более приоритетную.
 
-AI-ответ строится по контексту из публичного API. Если данных в контексте
-недостаточно, ассистент должен сообщить об этом, а не выдумывать сведения.
+Если данных в контексте недостаточно, ассистент должен сообщить об этом, а не
+выдумывать сведения.
 
 ## Назначение
 
-Первый релиз CLI дает прямой терминальный доступ к открытым данным и командам
-подключения MCP/skill. Дальше планируется добавить режим AI-запросов через
-ключ пользователя для OpenAI/OpenRouter и интерактивный агентный режим.
+CLI дает прямой терминальный доступ к открытым данным городского округа,
+командам подключения MCP/skill, AI-запросам через Ollama/OpenAI/OpenRouter,
+интерактивному агентному режиму, экспорту данных и проверке обновлений.
 
 ## Переменные окружения
 

package/package.json

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

package/src/cli.js

@@ -17,6 +17,16 @@ const DEFAULT_AI_CONFIG = {
     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 +44,15 @@ const BANNER = `\x1b[38;5;45m┌────────────────
 const COMMANDS = new Map([
   ["help", showHelp],
   ["version", showVersion],
+  ["update", checkUpdate],
   ["banner", showBanner],
   ["agent", startAgent],
+  ["chat", startAgent],
   ["ai", handleAi],
+  ["init", initCli],
   ["health", checkHealth],
   ["layers", listLayers],
+  ["data", handleData],
   ["schools", listSchools],
   ["kindergartens", listKindergartens],
   ["search", searchAll],
@@ -64,7 +78,12 @@ async function showHelp() {
 Usage:
   iola banner
   iola agent
+  iola chat
+  iola init
+  iola update
+  iola data LAYER [--limit 10] [--search TEXT] [--format table|json|csv]
   iola ai ask TEXT [--provider ollama|openai|openrouter] [--model MODEL]
+  iola ai context TEXT [--json]
   iola ai key set openai
   iola ai key set openrouter
   iola ai key status
@@ -74,11 +93,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] [--format table|json|csv]
   iola schools get --inn INN [--json]
-  iola kindergartens [--limit 10] [--search TEXT] [--json]
+  iola kindergartens [--limit 10] [--search TEXT] [--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
@@ -163,6 +182,21 @@ async function handleAgentLine(line, state) {
     return false;
   }
 
+  if (command === "context") {
+    await aiContext(args);
+    return false;
+  }
+
+  if (command === "use") {
+    await useAiProvider(args);
+    return false;
+  }
+
+  if (command === "key") {
+    await handleAiKey(args);
+    return false;
+  }
+
   if (command === "provider") {
     await printAiConfigField("provider");
     return false;
@@ -178,6 +212,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;
@@ -186,6 +230,7 @@ async function handleAgentLine(line, state) {
   const mapped = {
     health: ["health", args],
     layers: ["layers", args],
+    data: ["data", args],
     schools: ["schools", args],
     kindergartens: ["kindergartens", args],
     search: ["search", args],
@@ -209,20 +254,28 @@ function printAgentHelp() {
   /help
   /health
   /layers
+  /data schools --limit 10
   /schools --limit 10
   /schools get --inn 1215067180
   /kindergartens --search 29
   /kindergartens get --inn 1215077421
   /search лицей --limit 3
   /mcp-info
+  /context школа 29
   /ai doctor
   /ai setup ollama
+  /use openai
+  /use ollama
+  /key status
+  /key set openai
   /config
   /provider
   /model
   /history
   /clear
   /banner
+  /update
+  /init
   /exit
 
 Обычный текст без slash-команды отправляется в настроенный AI-провайдер.`);
@@ -261,9 +314,43 @@ 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) {
@@ -283,6 +370,41 @@ async function checkHealth(args) {
   });
 }
 
+async function initCli(args = []) {
+  const options = parseOptions(args);
+
+  showBanner();
+  console.log("Проверка окружения");
+  printKeyValue({
+    node: process.version,
+    npm: await getCommandVersion("npm", ["--version"]),
+    api: await probeEndpoint(`${MCP_BASE_URL}/mcp-health`),
+    mcp: MCP_BASE_URL,
+  });
+  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;
 
@@ -290,6 +412,7 @@ async function handleAi(args) {
     showBanner();
     console.log(`AI-команды:
   iola ai ask TEXT [--provider ollama|openai|openrouter] [--model MODEL]
+  iola ai context TEXT [--json]
   iola ai key set openai
   iola ai key set openrouter
   iola ai key status
@@ -309,6 +432,11 @@ async function handleAi(args) {
     return;
   }
 
+  if (subcommand === "context") {
+    await aiContext(rest);
+    return;
+  }
+
   if (subcommand === "key") {
     await handleAiKey(rest);
     return;
@@ -366,7 +494,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;
   }
 
@@ -403,6 +532,53 @@ async function handleAiKey(args) {
   iola ai key delete openai|openrouter`);
 }
 
+async function useAiProvider(args) {
+  const [provider] = args;
+
+  if (provider !== "ollama" && provider !== "openai" && provider !== "openrouter") {
+    throw new Error("Провайдер должен быть ollama, openai или openrouter.");
+  }
+
+  const config = await loadConfig();
+  const defaultModel = {
+    ollama: config.ai.provider === "ollama" ? config.ai.model : "llama3.2:1b",
+    openai: config.ai.provider === "openai" ? config.ai.model : "gpt-4.1-mini",
+    openrouter: config.ai.provider === "openrouter" ? config.ai.model : "openai/gpt-4.1-mini",
+  }[provider];
+
+  await saveConfig({
+    ai: {
+      provider,
+      model: defaultModel,
+      baseUrl: provider === "ollama"
+        ? "http://127.0.0.1:11434"
+        : provider === "openai"
+          ? "https://api.openai.com/v1"
+          : "https://openrouter.ai/api/v1",
+    },
+  });
+
+  console.log(`AI-провайдер переключен: ${provider}, модель: ${defaultModel}`);
+}
+
+async function aiContext(args) {
+  const options = parseOptions(args);
+  const query = options._.join(" ").trim();
+
+  if (!query) {
+    throw new Error('Текст запроса обязателен. Пример: iola ai context "школа 29"');
+  }
+
+  const context = await buildDataContext(query);
+
+  if (options.json) {
+    printJson(context);
+    return;
+  }
+
+  printContext(context);
+}
+
 async function setAiKey(provider) {
   assertKeyProvider(provider);
 
@@ -550,11 +726,23 @@ async function buildDataContext(question) {
     fetchJson(`${API_BASE_URL}/kindergartens?limit=100&offset=0`),
   ]);
   const queryTerms = extractSearchTerms(question);
-  const schoolItems = findRelevantItems(normalizeItems(schools), queryTerms).slice(0, 8);
-  const kindergartenItems = findRelevantItems(normalizeItems(kindergartens), queryTerms).slice(0, 8);
+  const patterns = extractStructuredPatterns(question);
+  const includeSchools = patterns.targetLayers.length === 0 || patterns.targetLayers.includes("schools");
+  const includeKindergartens = patterns.targetLayers.length === 0 || patterns.targetLayers.includes("kindergartens");
+  const schoolItems = includeSchools
+    ? findRelevantItems(normalizeItems(schools), queryTerms, patterns, "schools").slice(0, 8)
+    : [];
+  const kindergartenItems = includeKindergartens
+    ? findRelevantItems(normalizeItems(kindergartens), queryTerms, patterns, "kindergartens").slice(0, 8)
+    : [];
 
   return {
     layers: layers.data_layers || [],
+    query: {
+      text: question,
+      terms: queryTerms,
+      patterns,
+    },
     schools: schoolItems.map(selectPublicSummary),
     kindergartens: kindergartenItems.map(selectPublicSummary),
   };
@@ -572,29 +760,94 @@ function extractSearchTerms(question) {
   return normalized.length > 0 ? normalized : [question];
 }
 
-function findRelevantItems(items, terms) {
+function extractStructuredPatterns(question) {
+  const normalized = question.toLocaleLowerCase("ru-RU");
+  const numbers = [...new Set([...normalized.matchAll(/\b\d{1,3}\b/g)].map((match) => match[0]))];
+  const inns = [...new Set([...normalized.matchAll(/\b\d{10,12}\b/g)].map((match) => match[0]))];
+  const targetLayers = [];
+  if (/(^|[^а-яёa-z])(школа|школы|лицей|лицея|гимназия|гимназии)(?=$|[^а-яёa-z])/iu.test(normalized)) {
+    targetLayers.push("schools");
+  }
+  if (/(^|[^а-яёa-z])(сад|сады|детсад|детский|детские|доу|мбдоу)(?=$|[^а-яёa-z])/iu.test(normalized)) {
+    targetLayers.push("kindergartens");
+  }
+  const streetMatches = [
+    ...normalized.matchAll(/(?:улица|ул\.?)\s+([а-яёa-z0-9 .-]+)/giu),
+    ...normalized.matchAll(/([а-яёa-z0-9 .-]+)\s+(?:улица|ул\.?)/giu),
+  ];
+  const streets = [...new Set(streetMatches.map((match) => cleanupPattern(match[1])).filter(Boolean))];
+
+  return { numbers, inns, streets, targetLayers: [...new Set(targetLayers)] };
+}
+
+function cleanupPattern(value) {
+  return value
+    .replace(/\b(школа|школы|сад|детский|детские|сады|лицей|гимназия|контакты|телефон|адрес|найди|покажи)\b/giu, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function findRelevantItems(items, terms, patterns, layer) {
   return items
     .map((item) => ({
       item,
-      score: scoreItem(item, terms),
+      score: scoreItem(item, terms, patterns, layer),
     }))
     .filter((entry) => entry.score > 0)
     .sort((left, right) => right.score - left.score)
     .map((entry) => entry.item);
 }
 
-function scoreItem(item, terms) {
-  const text = JSON.stringify(selectPublicSummary(item)).toLocaleLowerCase("ru-RU");
-  return terms.reduce((score, term) => score + (text.includes(term.toLocaleLowerCase("ru-RU")) ? 1 : 0), 0);
+function scoreItem(item, terms, patterns, layer) {
+  const summary = selectPublicSummary(item);
+  const text = JSON.stringify(summary).toLocaleLowerCase("ru-RU");
+  const name = String(summary.name || "").toLocaleLowerCase("ru-RU");
+  const address = String(summary.address || "").toLocaleLowerCase("ru-RU");
+  const generalTerms = terms.filter((term) => !/^\d+$/.test(term));
+  let score = generalTerms.reduce((value, term) => value + (text.includes(term.toLocaleLowerCase("ru-RU")) ? 1 : 0), 0);
+
+  for (const inn of patterns.inns) {
+    if (String(summary.inn) === inn) {
+      score += 20;
+    }
+  }
+
+  for (const number of patterns.numbers) {
+    const numberPatterns = [
+      `№ ${number}`,
+      `№${number}`,
+      `школа ${number}`,
+      `сад ${number}`,
+      `лицей ${number}`,
+      `гимназия ${number}`,
+    ];
+
+    if (numberPatterns.some((pattern) => name.includes(pattern))) {
+      score += 12;
+      if (patterns.targetLayers.length === 0 || patterns.targetLayers.includes(layer)) {
+        score += 5;
+      }
+    }
+  }
+
+  for (const street of patterns.streets) {
+    if (street && address.includes(street)) {
+      score += 8;
+    }
+  }
+
+  return score;
 }
 
 function buildAiMessages(question, dataContext, history) {
+  const sourceLines = buildSourceLines(dataContext);
   const system = [
     "Ты терминальный AI-ассистент CLI-проекта Йошкар-Олы.",
     "Отвечай на русском языке.",
     "Используй только данные из переданного контекста.",
     "Если в контексте нет нужных сведений, прямо напиши, что данных недостаточно.",
     "Не выдумывай адреса, телефоны, лицензии и руководителей.",
+    "Если отвечаешь по конкретным организациям, укажи источник в конце: слой, название и ИНН.",
     "Отвечай кратко и по делу.",
   ].join(" ");
   const contextText = JSON.stringify(dataContext, null, 2);
@@ -605,11 +858,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);
@@ -737,6 +1005,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);
 
@@ -749,16 +1039,21 @@ 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(`${API_BASE_URL}/${DATASETS[dataset].endpoint}?${params}`);
   const items = normalizeItems(data);
   const filtered = options.search ? filterItems(items, options.search) : items;
   const limited = filtered.slice(0, Number(options.limit || 20));
 
-  if (options.json) {
+  if (options.json || options.format === "json") {
     printJson(limited);
     return;
   }
 
+  if (options.format === "csv") {
+    printCsv(limited.map(selectPublicSummary));
+    return;
+  }
+
   printDatasetTable(limited);
 }
 
@@ -767,7 +1062,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(`${API_BASE_URL}/${DATASETS[dataset].endpoint}?limit=500&offset=0`);
   const item = normalizeItems(data).find((entry) => String(entry.inn) === String(options.inn));
 
   if (!item) {
@@ -801,11 +1096,19 @@ async function searchAll(args) {
     kindergartens: filterItems(normalizeItems(kindergartens), query).slice(0, limit),
   };
 
-  if (options.json) {
+  if (options.json || options.format === "json") {
     printJson(result);
     return;
   }
 
+  if (options.format === "csv") {
+    printCsv([
+      ...result.schools.map((item) => ({ layer: "schools", ...selectPublicSummary(item) })),
+      ...result.kindergartens.map((item) => ({ layer: "kindergartens", ...selectPublicSummary(item) })),
+    ]);
+    return;
+  }
+
   console.log("Школы");
   printDatasetTable(result.schools);
   console.log("");
@@ -832,7 +1135,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 === "--inn" || arg === "--model" || arg === "--provider" || arg === "--format") {
       result[arg.slice(2)] = args[index + 1];
       index += 1;
     } else {
@@ -985,6 +1290,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;
@@ -1055,8 +1420,10 @@ async function confirm(question) {
 }
 
 async function saveConfig(value) {
+  const current = await loadConfig();
+  const merged = mergeConfig(current, value);
   await mkdir(CONFIG_DIR, { recursive: true });
-  await writeFile(CONFIG_FILE, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+  await writeFile(CONFIG_FILE, `${JSON.stringify(merged, null, 2)}\n`, "utf8");
 }
 
 async function loadConfig() {
@@ -1100,6 +1467,45 @@ async function printAiConfig() {
   });
 }
 
+function printContext(context) {
+  const layerNames = context.layers.map((layer) => layer.name || layer.id || String(layer));
+  console.log(`Запрос: ${context.query.text}`);
+  console.log(`Слова поиска: ${context.query.terms.length > 0 ? context.query.terms.join(", ") : "-"}`);
+  console.log(`Номера: ${context.query.patterns.numbers.length > 0 ? context.query.patterns.numbers.join(", ") : "-"}`);
+  console.log(`ИНН: ${context.query.patterns.inns.length > 0 ? context.query.patterns.inns.join(", ") : "-"}`);
+  console.log(`Улицы: ${context.query.patterns.streets.length > 0 ? context.query.patterns.streets.join(", ") : "-"}`);
+  console.log(`Целевые слои: ${context.query.patterns.targetLayers.length > 0 ? context.query.patterns.targetLayers.join(", ") : "все"}`);
+  console.log("");
+  console.log(`Слои данных: ${layerNames.length > 0 ? layerNames.join(", ") : "-"}`);
+  console.log("");
+
+  if (context.schools.length > 0) {
+    console.log("Школы в контексте:");
+    printTable(context.schools, [
+      ["name", "Название"],
+      ["address", "Адрес"],
+      ["phone", "Телефон"],
+      ["inn", "ИНН"],
+    ]);
+  } else {
+    console.log("Школы в контексте: нет совпадений");
+  }
+
+  console.log("");
+
+  if (context.kindergartens.length > 0) {
+    console.log("Детские сады в контексте:");
+    printTable(context.kindergartens, [
+      ["name", "Название"],
+      ["address", "Адрес"],
+      ["phone", "Телефон"],
+      ["inn", "ИНН"],
+    ]);
+  } else {
+    console.log("Детские сады в контексте: нет совпадений");
+  }
+}
+
 async function printAiConfigField(field) {
   const config = await loadConfig();
   console.log(config.ai[field] || "-");
@@ -1149,6 +1555,24 @@ function printJson(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 
+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) {
   printTable(items.map(selectPublicSummary), [
     ["inn", "ИНН"],