@iola_adm/iola-cli 0.1.11 → 0.1.13

package/README.md

@@ -18,7 +18,11 @@ node --version
 npm --version
 ```
 
-Нужен Node.js `18` или новее. Если Node.js не установлен:
+Нужен Node.js `22.5.0` или новее. Это нужно для встроенной SQLite-БД
+`node:sqlite`, которую CLI будет использовать для локальной истории, кеша и
+сессий без дополнительных нативных зависимостей.
+
+Если Node.js не установлен или версия ниже `22.5.0`:
 
 ```bash
 # Windows
@@ -54,6 +58,8 @@ curl -fsSL https://ollama.com/install.sh | sh
 Диагностика ПК и подбор локальной модели:
 
 ```bash
+npx -y @iola_adm/iola-cli init
+npx -y @iola_adm/iola-cli init --upgrade-node
 npx -y @iola_adm/iola-cli ai doctor
 npx -y @iola_adm/iola-cli ai setup ollama
 ```
@@ -81,6 +87,10 @@ iola agent
 iola chat
 iola init
 iola doctor
+iola db status
+iola db init
+iola history --limit 20
+iola history clear
 iola config get
 iola config set api.baseUrl https://apiiola.yasg.ru/api/v1
 iola config reset
@@ -133,6 +143,7 @@ iola agent
 /help
 /health
 /doctor
+/db status
 /config get
 /layers
 /data schools --limit 10
@@ -154,6 +165,7 @@ iola agent
 /provider
 /config
 /history
+/history --limit 20
 /clear
 /update
 /init
@@ -265,6 +277,34 @@ CLI дает прямой терминальный доступ к открыт
 командам подключения MCP/skill, AI-запросам через Ollama/OpenAI/OpenRouter,
 интерактивному агентному режиму, экспорту данных и проверке обновлений.
 
+## Локальная SQLite-БД
+
+CLI использует встроенный `node:sqlite` и хранит локальную БД в профиле
+пользователя:
+
+```text
+%USERPROFILE%\.iola\iola.db
+```
+
+БД создается автоматически при установке npm-пакета и при `iola init`.
+В ней хранятся история AI-запросов, контекст ответа, ошибки выполнения,
+служебная таблица версии схемы, а также подготовлены таблицы для кеша API и
+сохраненных выборок.
+
+Команды:
+
+```bash
+iola db status
+iola db init
+iola db reset
+iola history --limit 20
+iola history --json
+iola history clear
+```
+
+Ключи OpenAI/OpenRouter в SQLite не сохраняются. Они остаются в локальном
+`secrets.json` или в переменных окружения.
+
 ## Переменные окружения
 
 ```bash

package/bin/iola.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env -S node --no-warnings
 
 import { main } from "../src/cli.js";
 
@@ -6,4 +6,3 @@ main(process.argv.slice(2)).catch((error) => {
   console.error(error instanceof Error ? error.message : String(error));
   process.exitCode = 1;
 });
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "CLI и AI-агент для работы с открытыми данными городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",
@@ -15,6 +15,11 @@
   "bin": {
     "iola": "bin/iola.js"
   },
+  "scripts": {
+    "postinstall": "node --no-warnings bin/iola.js db init --silent || true",
+    "start": "node --no-warnings bin/iola.js",
+    "test": "node --no-warnings --check bin/iola.js && node --no-warnings --check src/cli.js"
+  },
   "files": [
     "bin",
     "src",
@@ -25,10 +30,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "start": "node bin/iola.js",
-    "test": "node --check bin/iola.js && node --check src/cli.js"
-  },
   "keywords": [
     "yoshkar-ola",
     "open-data",
@@ -36,6 +37,6 @@
     "cli"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22.5.0"
   }
 }

package/src/cli.js

@@ -1,15 +1,20 @@
 import { execFile } from "node:child_process";
+import { mkdirSync } from "node:fs";
 import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import readline from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
+import { DatabaseSync } from "node:sqlite";
 
 const API_BASE_URL = process.env.IOLA_API_BASE_URL || "https://apiiola.yasg.ru/api/v1";
 const MCP_BASE_URL = process.env.IOLA_MCP_BASE_URL || "https://apiiola.yasg.ru";
+const MIN_NODE_VERSION = "22.5.0";
 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 DB_FILE = path.join(CONFIG_DIR, "iola.db");
+const DB_SCHEMA_VERSION = 1;
 const DEFAULT_AI_CONFIG = {
   api: {
     baseUrl: "https://apiiola.yasg.ru/api/v1",
@@ -75,6 +80,8 @@ const COMMANDS = new Map([
   ["version", showVersion],
   ["update", checkUpdate],
   ["doctor", doctor],
+  ["db", handleDb],
+  ["history", handleHistory],
   ["config", handleConfig],
   ["banner", showBanner],
   ["agent", startAgent],
@@ -94,6 +101,11 @@ const COMMANDS = new Map([
 
 export async function main(argv) {
   const [command = "help", ...args] = argv;
+  const nodeStatus = getNodeRequirementStatus();
+  if (!nodeStatus.ok && !["help", "version", "doctor", "init"].includes(command)) {
+    throw new Error(`Нужен Node.js ${MIN_NODE_VERSION} или новее. Сейчас: ${nodeStatus.current}. Запустите: iola init --upgrade-node`);
+  }
+
   const handler = COMMANDS.get(command);
 
   if (!handler) {
@@ -113,6 +125,10 @@ Usage:
   iola chat
   iola init
   iola doctor
+  iola db status
+  iola db init
+  iola history [--limit 20]
+  iola history clear
   iola config get
   iola config set api.baseUrl URL
   iola config set api.mcpBaseUrl URL
@@ -148,6 +164,9 @@ Usage:
 Environment:
   IOLA_API_BASE_URL   default: ${API_BASE_URL}
   IOLA_MCP_BASE_URL   default: ${MCP_BASE_URL}
+
+Requirements:
+  Node.js >= ${MIN_NODE_VERSION}
 `);
 }
 
@@ -216,7 +235,16 @@ async function handleAgentLine(line, state) {
   }
 
   if (command === "history") {
-    printAgentHistory(state.history);
+    if (args.length > 0) {
+      await handleHistory(args);
+    } else {
+      printAgentHistory(state.history);
+    }
+    return false;
+  }
+
+  if (command === "db") {
+    await handleDb(args);
     return false;
   }
 
@@ -298,6 +326,8 @@ async function handleAgentLine(line, state) {
   const mapped = {
     health: ["health", args],
     doctor: ["doctor", args],
+    db: ["db", args],
+    history: ["history", args],
     config: ["config", args],
     layers: ["layers", args],
     data: ["data", args],
@@ -324,6 +354,7 @@ function printAgentHelp() {
   /help
   /health
   /doctor
+  /db status
   /config get
   /config set api.baseUrl URL
   /layers
@@ -348,6 +379,7 @@ function printAgentHelp() {
   /provider
   /model
   /history
+  /history --limit 20
   /clear
   /banner
   /update
@@ -461,7 +493,11 @@ async function doctor(args = []) {
       version: packageJson.default.version,
       npmLatest: latest || "-",
       update: getUpdateStatus(packageJson.default.version, latest),
+      node: process.version,
+      nodeRequired: `>=${MIN_NODE_VERSION}`,
+      nodeStatus: getNodeRequirementStatus().ok ? "ok" : "upgrade-required",
     },
+    db: getDbStatus(),
     api: {
       baseUrl: apiBaseUrl,
       mcpBaseUrl,
@@ -487,6 +523,9 @@ async function doctor(args = []) {
   console.log("CLI");
   printKeyValue(report.cli);
   console.log("");
+  console.log("SQLite");
+  printKeyValue(report.db);
+  console.log("");
   console.log("API/MCP");
   printKeyValue(report.api);
   console.log("");
@@ -514,6 +553,69 @@ function getUpdateStatus(current, latest) {
   return "ok";
 }
 
+function getNodeRequirementStatus() {
+  const current = process.versions.node;
+  return {
+    current,
+    required: MIN_NODE_VERSION,
+    ok: compareVersions(current, MIN_NODE_VERSION) >= 0,
+  };
+}
+
+async function offerNodeUpgrade(options, status) {
+  console.log(`Текущая версия Node.js: ${status.current}. Нужна ${MIN_NODE_VERSION} или новее.`);
+
+  if (!process.stdin.isTTY && !options["upgrade-node"]) {
+    printNodeUpgradeInstructions();
+    return;
+  }
+
+  const shouldUpgrade = options["upgrade-node"] || (await confirm("Обновить Node.js установщиком сейчас? [y/N] "));
+
+  if (!shouldUpgrade) {
+    printNodeUpgradeInstructions();
+    return;
+  }
+
+  await upgradeNodeWithInstaller();
+  console.log("");
+  console.log("После обновления перезапустите терминал и проверьте:");
+  console.log("  node --version");
+  console.log("  iola init");
+}
+
+function printNodeUpgradeInstructions() {
+  console.log("Обновите Node.js:");
+  console.log("  Windows: winget install OpenJS.NodeJS.LTS");
+  console.log("  macOS:   brew install node");
+  console.log("  Linux:   curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs");
+}
+
+async function upgradeNodeWithInstaller() {
+  if (process.platform === "win32") {
+    try {
+      await runCommand("winget", ["upgrade", "OpenJS.NodeJS.LTS", "--accept-package-agreements", "--accept-source-agreements"], { inherit: true });
+    } catch {
+      await runCommand("winget", ["install", "OpenJS.NodeJS.LTS", "--accept-package-agreements", "--accept-source-agreements"], { inherit: true });
+    }
+    return;
+  }
+
+  if (process.platform === "darwin") {
+    try {
+      await runCommand("brew", ["upgrade", "node"], { inherit: true });
+    } catch {
+      await runCommand("brew", ["install", "node"], { inherit: true });
+    }
+    return;
+  }
+
+  await runCommand("sh", [
+    "-c",
+    "curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs",
+  ], { inherit: true });
+}
+
 async function checkConfiguredModel(config) {
   if (config.ai.provider !== "ollama") {
     return "external-api";
@@ -536,17 +638,29 @@ async function checkConfiguredModel(config) {
 
 async function initCli(args = []) {
   const options = parseOptions(args);
+  const nodeStatus = getNodeRequirementStatus();
 
   showBanner();
   console.log("Проверка окружения");
+  initDatabase();
+  const dbStatus = getDbStatus();
   printKeyValue({
     node: process.version,
+    node_required: `>=${MIN_NODE_VERSION}`,
+    node_status: nodeStatus.ok ? "ok" : "нужно обновить",
     npm: await getCommandVersion("npm", ["--version"]),
     api: await probeEndpoint(`${await getMcpBaseUrl()}/mcp-health`),
     mcp: await getMcpBaseUrl(),
+    sqlite: dbStatus.status,
+    sqlite_file: dbStatus.file,
   });
   console.log("");
 
+  if (!nodeStatus.ok) {
+    await offerNodeUpgrade(options, nodeStatus);
+    console.log("");
+  }
+
   await aiDoctor(options.json ? ["--json"] : []);
 
   if (!process.stdin.isTTY || options.yes) {
@@ -680,6 +794,65 @@ async function handleConfig(args) {
   throw new Error("Команды config: get, set, reset.");
 }
 
+async function handleDb(args) {
+  const [action = "status"] = args;
+  const options = parseOptions(args);
+
+  if (action === "init") {
+    initDatabase();
+    if (!options.silent) {
+      console.log(`SQLite-БД готова: ${DB_FILE}`);
+    }
+    return;
+  }
+
+  if (action === "status") {
+    printKeyValue(getDbStatus());
+    return;
+  }
+
+  if (action === "reset") {
+    const shouldReset = await confirm("Удалить локальную SQLite-БД iola.db? [y/N] ");
+    if (!shouldReset) {
+      console.log("Сброс отменен.");
+      return;
+    }
+    await rm(DB_FILE, { force: true });
+    initDatabase();
+    console.log(`SQLite-БД пересоздана: ${DB_FILE}`);
+    return;
+  }
+
+  throw new Error("Команды db: status, init, reset.");
+}
+
+async function handleHistory(args) {
+  const [action] = args;
+  const options = parseOptions(args);
+
+  if (action === "clear") {
+    clearHistory();
+    console.log("История очищена.");
+    return;
+  }
+
+  const rows = listHistory(Number(options.limit || 20));
+
+  if (options.json) {
+    printJson(rows);
+    return;
+  }
+
+  printTable(rows, [
+    ["id", "ID"],
+    ["created_at", "Дата"],
+    ["profile", "Профиль"],
+    ["provider", "Провайдер"],
+    ["question", "Вопрос"],
+    ["answer", "Ответ"],
+  ]);
+}
+
 async function aiDoctor(args) {
   const options = parseOptions(args);
   const diagnostics = await getLocalDiagnostics();
@@ -1167,6 +1340,142 @@ async function deleteAiKey(provider) {
   console.log(`Локальный ключ ${provider} удален.`);
 }
 
+function openDatabase() {
+  const db = new DatabaseSync(DB_FILE);
+  db.exec("PRAGMA busy_timeout = 5000;");
+  return db;
+}
+
+function initDatabase() {
+  mkdirSyncSafe(CONFIG_DIR);
+  const db = openDatabase();
+  try {
+    db.exec(`
+      CREATE TABLE IF NOT EXISTS meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS ask_history (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        profile TEXT,
+        provider TEXT,
+        model TEXT,
+        question TEXT NOT NULL,
+        answer TEXT NOT NULL,
+        context_json TEXT NOT NULL,
+        error TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_ask_history_created_at ON ask_history(created_at DESC);
+      CREATE TABLE IF NOT EXISTS api_cache (
+        key TEXT PRIMARY KEY,
+        url TEXT NOT NULL,
+        response_json TEXT NOT NULL,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        expires_at TEXT
+      );
+      CREATE TABLE IF NOT EXISTS saved_views (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT NOT NULL UNIQUE,
+        dataset TEXT NOT NULL,
+        query_json TEXT NOT NULL,
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+    `);
+    db.prepare(`
+      INSERT INTO meta(key, value) VALUES ('schema_version', ?)
+      ON CONFLICT(key) DO UPDATE SET value = excluded.value
+    `).run(String(DB_SCHEMA_VERSION));
+  } finally {
+    db.close();
+  }
+}
+
+function mkdirSyncSafe(directory) {
+  try {
+    mkdirSync(directory, { recursive: true });
+  } catch {
+    // Directory creation is retried by write operations where needed.
+  }
+}
+
+function getDbStatus() {
+  try {
+    initDatabase();
+    const db = openDatabase();
+    try {
+      const schema = db.prepare("SELECT value FROM meta WHERE key = 'schema_version'").get();
+      const history = db.prepare("SELECT COUNT(*) AS count FROM ask_history").get();
+      return {
+        status: "ok",
+        file: DB_FILE,
+        schema: schema?.value || "-",
+        history: history?.count ?? 0,
+      };
+    } finally {
+      db.close();
+    }
+  } catch (error) {
+    return {
+      status: "error",
+      file: DB_FILE,
+      schema: "-",
+      history: "-",
+      error: error instanceof Error ? error.message : String(error),
+    };
+  }
+}
+
+function recordAskHistory({ question, answer, providerConfig, dataContext, error }) {
+  try {
+    initDatabase();
+    const db = openDatabase();
+    try {
+      db.prepare(`
+        INSERT INTO ask_history(profile, provider, model, question, answer, context_json, error)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `).run(
+        providerConfig.name || "",
+        providerConfig.provider || "",
+        providerConfig.model || "",
+        question,
+        answer,
+        JSON.stringify(dataContext),
+        error || "",
+      );
+    } finally {
+      db.close();
+    }
+  } catch {
+    // History must never break the main answer path.
+  }
+}
+
+function listHistory(limit) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    return db.prepare(`
+      SELECT id, created_at, profile, provider, model, question, answer, error
+      FROM ask_history
+      ORDER BY id DESC
+      LIMIT ?
+    `).all(limit);
+  } finally {
+    db.close();
+  }
+}
+
+function clearHistory() {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    db.exec("DELETE FROM ask_history");
+  } finally {
+    db.close();
+  }
+}
+
 function assertKeyProvider(provider) {
   if (provider !== "openai" && provider !== "openrouter") {
     throw new Error("Провайдер должен быть openai или openrouter.");
@@ -1258,7 +1567,18 @@ async function aiAsk(args, context = {}) {
   const providerConfig = resolveAiProfile(config, options);
   const dataContext = await buildDataContext(question);
   const messages = buildAiMessages(question, dataContext, context.history || []);
-  const answer = await callAiProvider(providerConfig, messages);
+  let answer = "";
+  let errorMessage = "";
+
+  try {
+    answer = await callAiProvider(providerConfig, messages);
+  } catch (error) {
+    errorMessage = error instanceof Error ? error.message : String(error);
+    recordAskHistory({ question, answer: "", providerConfig, dataContext, error: errorMessage });
+    throw error;
+  }
+
+  recordAskHistory({ question, answer, providerConfig, dataContext, error: "" });
 
   console.log(answer);
   return answer;
@@ -1742,10 +2062,11 @@ function parseOptions(args) {
 
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
-    if (arg === "--json" || arg === "--yes") {
+    if (arg === "--json" || arg === "--yes" || arg === "--silent") {
       result[arg.slice(2)] = true;
-    } else if (arg === "--check") {
+    } else if (arg === "--check" || arg === "--upgrade-node") {
       result.check = true;
+      result[arg.slice(2)] = true;
     } else if (arg === "--limit" || arg === "--offset" || arg === "--search" || arg === "--where" || arg === "--columns" || arg === "--inn" || arg === "--model" || arg === "--provider" || arg === "--profile" || arg === "--name" || arg === "--base-url" || arg === "--sandbox" || arg === "--approval" || arg === "--cwd" || arg === "--codex-profile" || arg === "--format") {
       result[arg.slice(2)] = args[index + 1];
       index += 1;