@iola_adm/iola-cli 0.1.12 → 0.1.14

package/README.md

@@ -87,12 +87,26 @@ iola agent
 iola chat
 iola init
 iola doctor
+iola db status
+iola db init
+iola history --limit 20
+iola history clear
+iola sessions --limit 20
+iola resume 1 "продолжи"
+iola fork 1 "новый вопрос"
+iola features list
+iola features enable api-cache
+iola mcp status
+iola mcp list
+iola mcp install codex
 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 ask "Найди школу 29" --profile codex --events --output answer.txt
+iola ask "Найди школу 29" --schema json --no-history
 iola data schools --limit 10
 iola data kindergartens --search "29"
 iola data schools --where address=Петрова --columns name,address,phone
@@ -139,6 +153,11 @@ iola agent
 /help
 /health
 /doctor
+/db status
+/sessions
+/resume 1
+/features list
+/mcp status
 /config get
 /layers
 /data schools --limit 10
@@ -160,6 +179,7 @@ iola agent
 /provider
 /config
 /history
+/history --limit 20
 /clear
 /update
 /init
@@ -271,6 +291,65 @@ 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
+iola sessions --limit 20
+iola sessions clear
+iola resume 1 "продолжи"
+iola fork 1 "новая ветка разговора"
+```
+
+Ключи OpenAI/OpenRouter в SQLite не сохраняются. Они остаются в локальном
+`secrets.json` или в переменных окружения.
+
+## Feature flags, MCP и машинный вывод
+
+Экспериментальные и системные возможности можно включать отдельно:
+
+```bash
+iola features list
+iola features enable api-cache
+iola features disable sqlite-history
+```
+
+MCP-интеграции:
+
+```bash
+iola mcp status
+iola mcp list
+iola mcp install codex
+iola mcp remove codex
+```
+
+Для автоматизации доступны события, JSON-ответ и запись результата в файл:
+
+```bash
+iola ask "Найди школу 29" --events
+iola ask "Найди школу 29" --schema json
+iola ask "Найди школу 29" --output answer.txt
+```
+
 ## Переменные окружения
 
 ```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.12",
+  "version": "0.1.14",
   "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",

package/src/cli.js

@@ -1,9 +1,11 @@
 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";
@@ -11,6 +13,16 @@ 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 = 2;
+const FEATURES = {
+  "sqlite-history": { stage: "stable", defaultEnabled: true, description: "Запись истории AI-запросов в SQLite." },
+  sessions: { stage: "stable", defaultEnabled: true, description: "Сессии, resume и fork для AI-диалогов." },
+  "api-cache": { stage: "experimental", defaultEnabled: false, description: "Локальный кеш API-ответов." },
+  events: { stage: "experimental", defaultEnabled: true, description: "JSONL-события выполнения ask." },
+  "mcp-management": { stage: "stable", defaultEnabled: true, description: "Команды управления MCP-интеграциями." },
+  "web-search": { stage: "experimental", defaultEnabled: false, description: "Резерв под web-search режимы AI." },
+};
 const DEFAULT_AI_CONFIG = {
   api: {
     baseUrl: "https://apiiola.yasg.ru/api/v1",
@@ -76,6 +88,13 @@ const COMMANDS = new Map([
   ["version", showVersion],
   ["update", checkUpdate],
   ["doctor", doctor],
+  ["db", handleDb],
+  ["history", handleHistory],
+  ["sessions", handleSessions],
+  ["resume", resumeSession],
+  ["fork", forkSession],
+  ["features", handleFeatures],
+  ["mcp", handleMcp],
   ["config", handleConfig],
   ["banner", showBanner],
   ["agent", startAgent],
@@ -119,12 +138,21 @@ Usage:
   iola chat
   iola init
   iola doctor
+  iola db status
+  iola db init
+  iola history [--limit 20]
+  iola history clear
+  iola sessions [--limit 20]
+  iola resume SESSION_ID [TEXT]
+  iola fork SESSION_ID [TEXT]
+  iola features list|enable|disable
+  iola mcp list|status|install|remove
   iola config get
   iola config set api.baseUrl URL
   iola config set api.mcpBaseUrl URL
   iola config reset
   iola update
-  iola ask TEXT
+  iola ask TEXT [--profile NAME] [--model MODEL] [--output FILE] [--schema json|table] [--events] [--no-history]
   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]
@@ -225,7 +253,41 @@ 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;
+  }
+
+  if (command === "sessions") {
+    await handleSessions(args);
+    return false;
+  }
+
+  if (command === "resume") {
+    await resumeSession(args);
+    return false;
+  }
+
+  if (command === "fork") {
+    await forkSession(args);
+    return false;
+  }
+
+  if (command === "features") {
+    await handleFeatures(args);
+    return false;
+  }
+
+  if (command === "mcp") {
+    await handleMcp(args);
     return false;
   }
 
@@ -307,6 +369,13 @@ async function handleAgentLine(line, state) {
   const mapped = {
     health: ["health", args],
     doctor: ["doctor", args],
+    db: ["db", args],
+    history: ["history", args],
+    sessions: ["sessions", args],
+    resume: ["resume", args],
+    fork: ["fork", args],
+    features: ["features", args],
+    mcp: ["mcp", args],
     config: ["config", args],
     layers: ["layers", args],
     data: ["data", args],
@@ -333,6 +402,11 @@ function printAgentHelp() {
   /help
   /health
   /doctor
+  /db status
+  /sessions
+  /resume SESSION_ID
+  /features list
+  /mcp status
   /config get
   /config set api.baseUrl URL
   /layers
@@ -357,6 +431,7 @@ function printAgentHelp() {
   /provider
   /model
   /history
+  /history --limit 20
   /clear
   /banner
   /update
@@ -474,6 +549,7 @@ async function doctor(args = []) {
       nodeRequired: `>=${MIN_NODE_VERSION}`,
       nodeStatus: getNodeRequirementStatus().ok ? "ok" : "upgrade-required",
     },
+    db: getDbStatus(),
     api: {
       baseUrl: apiBaseUrl,
       mcpBaseUrl,
@@ -496,9 +572,26 @@ async function doctor(args = []) {
     return;
   }
 
+  if (options.summary) {
+    printTable([
+      { group: "cli", status: report.cli.nodeStatus === "ok" && report.cli.update !== "available" ? "ok" : "check" },
+      { group: "sqlite", status: report.db.status },
+      { group: "api", status: report.api.health },
+      { group: "ai", status: report.ai.provider },
+      { group: "ollama", status: report.ai.ollama },
+    ], [
+      ["group", "Группа"],
+      ["status", "Статус"],
+    ]);
+    return;
+  }
+
   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("");
@@ -506,6 +599,11 @@ async function doctor(args = []) {
   printKeyValue(report.ai);
   console.log("");
   printDiagnostics(diagnostics, recommendOllamaModel(diagnostics));
+  if (options.all) {
+    console.log("");
+    console.log("Фичи");
+    await handleFeatures(["list"]);
+  }
 }
 
 function getUpdateStatus(current, latest) {
@@ -615,6 +713,8 @@ async function initCli(args = []) {
 
   showBanner();
   console.log("Проверка окружения");
+  initDatabase();
+  const dbStatus = getDbStatus();
   printKeyValue({
     node: process.version,
     node_required: `>=${MIN_NODE_VERSION}`,
@@ -622,6 +722,8 @@ async function initCli(args = []) {
     npm: await getCommandVersion("npm", ["--version"]),
     api: await probeEndpoint(`${await getMcpBaseUrl()}/mcp-health`),
     mcp: await getMcpBaseUrl(),
+    sqlite: dbStatus.status,
+    sqlite_file: dbStatus.file,
   });
   console.log("");
 
@@ -763,6 +865,187 @@ 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 handleSessions(args) {
+  const [action] = args;
+  if (action === "clear") {
+    clearSessions();
+    console.log("Сессии очищены.");
+    return;
+  }
+
+  const options = parseOptions(args);
+  const rows = listSessions(Number(options.limit || 20));
+
+  if (options.json) {
+    printJson(rows);
+    return;
+  }
+
+  printTable(rows, [
+    ["id", "ID"],
+    ["updated_at", "Обновлена"],
+    ["profile", "Профиль"],
+    ["provider", "Провайдер"],
+    ["model", "Модель"],
+    ["messages", "Сообщ."],
+    ["title", "Название"],
+  ]);
+}
+
+async function resumeSession(args) {
+  const [sessionId, ...questionParts] = args;
+  if (!sessionId) {
+    throw new Error("SESSION_ID обязателен. Пример: iola resume 1 \"продолжи\"");
+  }
+
+  const question = questionParts.join(" ").trim();
+  if (!question) {
+    printSessionMessages(Number(sessionId));
+    return;
+  }
+
+  const session = getSession(Number(sessionId));
+  await aiAsk([question, "--session", sessionId, "--profile", session.profile || "local"]);
+}
+
+async function forkSession(args) {
+  const [sessionId, ...questionParts] = args;
+  if (!sessionId) {
+    throw new Error("SESSION_ID обязателен. Пример: iola fork 1 \"новый вопрос\"");
+  }
+
+  const forkedId = forkSessionInDb(Number(sessionId));
+  console.log(`Создана новая сессия: ${forkedId}`);
+  const question = questionParts.join(" ").trim();
+  if (question) {
+    const session = getSession(forkedId);
+    await aiAsk([question, "--session", String(forkedId), "--profile", session.profile || "local"]);
+  }
+}
+
+async function handleFeatures(args) {
+  const [action = "list", name] = args;
+
+  if (action === "list" || action === "ls") {
+    const rows = listFeatures();
+    printTable(rows, [
+      ["name", "Фича"],
+      ["enabled", "Вкл"],
+      ["stage", "Стадия"],
+      ["description", "Описание"],
+    ]);
+    return;
+  }
+
+  if (action === "enable" || action === "disable") {
+    if (!name || !FEATURES[name]) {
+      throw new Error(`Неизвестная фича. Доступно: ${Object.keys(FEATURES).join(", ")}`);
+    }
+    setFeatureEnabled(name, action === "enable");
+    console.log(`${name}: ${action === "enable" ? "enabled" : "disabled"}`);
+    return;
+  }
+
+  throw new Error("Команды features: list, enable NAME, disable NAME.");
+}
+
+async function handleMcp(args) {
+  const [action = "status", target = "codex"] = args;
+
+  if (action === "status") {
+    const [health, version] = await Promise.all([
+      fetchJson(`${await getMcpBaseUrl()}/mcp-health`),
+      fetchJson(`${await getMcpBaseUrl()}/mcp-version`),
+    ]);
+    printKeyValue({
+      endpoint: `${await getMcpBaseUrl()}/mcp`,
+      status: health.status,
+      server_version: version.server_version,
+      layers: version.data_layers?.map((layer) => layer.id).join(", "),
+    });
+    return;
+  }
+
+  if (action === "list") {
+    await runCommand("codex", ["mcp", "list"], { inherit: true });
+    return;
+  }
+
+  if (action === "install" || action === "add") {
+    await setupClient([target]);
+    return;
+  }
+
+  if (action === "remove" || action === "delete") {
+    if (target !== "codex") {
+      throw new Error("Пока доступно удаление только Codex MCP.");
+    }
+    await runCommand("codex", ["mcp", "remove", "yoshkarOlaPublicData"], { inherit: true });
+    return;
+  }
+
+  throw new Error("Команды mcp: status, list, install codex, remove codex.");
+}
+
 async function aiDoctor(args) {
   const options = parseOptions(args);
   const diagnostics = await getLocalDiagnostics();
@@ -1250,6 +1533,335 @@ 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 sessions (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        parent_id INTEGER,
+        title TEXT NOT NULL,
+        profile TEXT,
+        provider TEXT,
+        model TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+      CREATE INDEX IF NOT EXISTS idx_sessions_updated_at ON sessions(updated_at DESC);
+      CREATE TABLE IF NOT EXISTS session_messages (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id INTEGER NOT NULL,
+        role TEXT NOT NULL,
+        content TEXT NOT NULL,
+        context_json TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        FOREIGN KEY(session_id) REFERENCES sessions(id) ON DELETE CASCADE
+      );
+      CREATE INDEX IF NOT EXISTS idx_session_messages_session_id ON session_messages(session_id, id);
+      CREATE TABLE IF NOT EXISTS feature_flags (
+        name TEXT PRIMARY KEY,
+        enabled INTEGER NOT NULL,
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+      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();
+      const sessions = db.prepare("SELECT COUNT(*) AS count FROM sessions").get();
+      return {
+        status: "ok",
+        file: DB_FILE,
+        schema: schema?.value || "-",
+        history: history?.count ?? 0,
+        sessions: sessions?.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, sessionId }) {
+  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 clearSessions() {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    db.exec("DELETE FROM session_messages; DELETE FROM sessions;");
+  } finally {
+    db.close();
+  }
+}
+
+function createSession(providerConfig, title, parentId = null) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    const result = db.prepare(`
+      INSERT INTO sessions(parent_id, title, profile, provider, model)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(parentId, title.slice(0, 120), providerConfig.name || "", providerConfig.provider || "", providerConfig.model || "");
+    return Number(result.lastInsertRowid);
+  } finally {
+    db.close();
+  }
+}
+
+function ensureSessionForAsk(options, providerConfig, question) {
+  if (options.session) {
+    return Number(options.session);
+  }
+  return createSession(providerConfig, question);
+}
+
+function appendSessionExchange(sessionId, question, answer, dataContext, error) {
+  if (!sessionId) {
+    return;
+  }
+  const db = openDatabase();
+  try {
+    db.prepare("INSERT INTO session_messages(session_id, role, content, context_json) VALUES (?, 'user', ?, ?)")
+      .run(sessionId, question, JSON.stringify(dataContext));
+    db.prepare("INSERT INTO session_messages(session_id, role, content, context_json) VALUES (?, 'assistant', ?, ?)")
+      .run(sessionId, error || answer || "", JSON.stringify({ error: error || "" }));
+    db.prepare("UPDATE sessions SET updated_at = datetime('now') WHERE id = ?").run(sessionId);
+  } finally {
+    db.close();
+  }
+}
+
+function listSessions(limit) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    return db.prepare(`
+      SELECT s.id, s.updated_at, s.profile, s.provider, s.model, s.title, COUNT(m.id) AS messages
+      FROM sessions s
+      LEFT JOIN session_messages m ON m.session_id = s.id
+      GROUP BY s.id
+      ORDER BY s.updated_at DESC, s.id DESC
+      LIMIT ?
+    `).all(limit);
+  } finally {
+    db.close();
+  }
+}
+
+function getSessionAiHistory(sessionId) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    return db.prepare("SELECT role, content FROM session_messages WHERE session_id = ? ORDER BY id ASC")
+      .all(sessionId)
+      .map((row) => ({ role: row.role, content: row.content }));
+  } finally {
+    db.close();
+  }
+}
+
+function getSession(sessionId) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    const session = db.prepare("SELECT * FROM sessions WHERE id = ?").get(sessionId);
+    if (!session) {
+      throw new Error(`Сессия не найдена: ${sessionId}`);
+    }
+    return session;
+  } finally {
+    db.close();
+  }
+}
+
+function printSessionMessages(sessionId) {
+  const rows = getSessionAiHistory(sessionId).map((row, index) => ({ id: index + 1, ...row }));
+  printTable(rows, [
+    ["id", "#"],
+    ["role", "Роль"],
+    ["content", "Текст"],
+  ]);
+}
+
+function forkSessionInDb(sessionId) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    const session = db.prepare("SELECT * FROM sessions WHERE id = ?").get(sessionId);
+    if (!session) {
+      throw new Error(`Сессия не найдена: ${sessionId}`);
+    }
+    const result = db.prepare(`
+      INSERT INTO sessions(parent_id, title, profile, provider, model)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(sessionId, `Fork: ${session.title}`, session.profile, session.provider, session.model);
+    const newId = Number(result.lastInsertRowid);
+    const messages = db.prepare("SELECT role, content, context_json FROM session_messages WHERE session_id = ? ORDER BY id ASC").all(sessionId);
+    const insert = db.prepare("INSERT INTO session_messages(session_id, role, content, context_json) VALUES (?, ?, ?, ?)");
+    for (const message of messages) {
+      insert.run(newId, message.role, message.content, message.context_json);
+    }
+    return newId;
+  } finally {
+    db.close();
+  }
+}
+
+function listFeatures() {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    return Object.entries(FEATURES).map(([name, meta]) => {
+      const row = db.prepare("SELECT enabled FROM feature_flags WHERE name = ?").get(name);
+      const enabled = row ? Boolean(row.enabled) : meta.defaultEnabled;
+      return { name, enabled: enabled ? "yes" : "no", stage: meta.stage, description: meta.description };
+    });
+  } finally {
+    db.close();
+  }
+}
+
+function isFeatureEnabled(name) {
+  const meta = FEATURES[name];
+  if (!meta) {
+    return false;
+  }
+  initDatabase();
+  const db = openDatabase();
+  try {
+    const row = db.prepare("SELECT enabled FROM feature_flags WHERE name = ?").get(name);
+    return row ? Boolean(row.enabled) : meta.defaultEnabled;
+  } finally {
+    db.close();
+  }
+}
+
+function setFeatureEnabled(name, enabled) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    db.prepare(`
+      INSERT INTO feature_flags(name, enabled, updated_at) VALUES (?, ?, datetime('now'))
+      ON CONFLICT(name) DO UPDATE SET enabled = excluded.enabled, updated_at = excluded.updated_at
+    `).run(name, enabled ? 1 : 0);
+  } finally {
+    db.close();
+  }
+}
+
 function assertKeyProvider(provider) {
   if (provider !== "openai" && provider !== "openrouter") {
     throw new Error("Провайдер должен быть openai или openrouter.");
@@ -1339,9 +1951,43 @@ async function aiAsk(args, context = {}) {
 
   const config = await loadConfig();
   const providerConfig = resolveAiProfile(config, options);
+  applyRuntimeConfig(providerConfig, options.config);
   const dataContext = await buildDataContext(question);
-  const messages = buildAiMessages(question, dataContext, context.history || []);
-  const answer = await callAiProvider(providerConfig, messages);
+  emitEvent(options, "context_loaded", { schools: dataContext.schools.length, kindergartens: dataContext.kindergartens.length });
+  const historyEnabled = !options["no-history"] && isFeatureEnabled("sqlite-history");
+  const sessionId = historyEnabled && isFeatureEnabled("sessions") ? ensureSessionForAsk(options, providerConfig, question) : null;
+  const history = context.history || (sessionId ? getSessionAiHistory(sessionId) : []);
+  const messages = buildAiMessages(question, dataContext, history, options);
+  let answer = "";
+  let errorMessage = "";
+
+  try {
+    emitEvent(options, "provider_selected", { profile: providerConfig.name, provider: providerConfig.provider, model: providerConfig.model });
+    answer = await callAiProvider(providerConfig, messages);
+  } catch (error) {
+    errorMessage = error instanceof Error ? error.message : String(error);
+    if (historyEnabled) {
+      recordAskHistory({ question, answer: "", providerConfig, dataContext, error: errorMessage, sessionId });
+      appendSessionExchange(sessionId, question, "", dataContext, errorMessage);
+    }
+    throw error;
+  }
+
+  if (historyEnabled) {
+    recordAskHistory({ question, answer, providerConfig, dataContext, error: "", sessionId });
+    appendSessionExchange(sessionId, question, answer, dataContext, "");
+  }
+
+  emitEvent(options, "answer", { length: answer.length, sessionId });
+
+  if (options.output) {
+    await writeFile(options.output, answer, "utf8");
+  }
+
+  if (options.format === "json" || options.schema === "json") {
+    printJson({ answer, profile: providerConfig.name, provider: providerConfig.provider, model: providerConfig.model, sessionId, context: dataContext });
+    return answer;
+  }
 
   console.log(answer);
   return answer;
@@ -1364,9 +2010,28 @@ function resolveAiProfile(config, options = {}) {
     provider,
     model: options.model || activeProfile.model || config.ai.model,
     baseUrl: options["base-url"] || activeProfile.baseUrl || config.ai.baseUrl,
+    temperature: options.temperature || activeProfile.temperature,
   };
 }
 
+function applyRuntimeConfig(target, value) {
+  if (!value) {
+    return;
+  }
+  const [key, ...parts] = String(value).split("=");
+  if (!key || parts.length === 0) {
+    throw new Error("Флаг --config должен быть в формате key=value.");
+  }
+  setConfigValue(target, key, parts.join("="));
+}
+
+function emitEvent(options, type, data) {
+  if (!options.events) {
+    return;
+  }
+  printJson({ type, at: new Date().toISOString(), ...data });
+}
+
 async function buildDataContext(question) {
   const apiBaseUrl = await getApiBaseUrl();
   const mcpBaseUrl = await getMcpBaseUrl();
@@ -1489,7 +2154,7 @@ function scoreItem(item, terms, patterns, layer) {
   return score;
 }
 
-function buildAiMessages(question, dataContext, history) {
+function buildAiMessages(question, dataContext, history, options = {}) {
   const sourceLines = buildSourceLines(dataContext);
   const system = [
     "Ты терминальный AI-ассистент CLI-проекта Йошкар-Олы.",
@@ -1498,8 +2163,10 @@ function buildAiMessages(question, dataContext, history) {
     "Если в контексте нет нужных сведений, прямо напиши, что данных недостаточно.",
     "Не выдумывай адреса, телефоны, лицензии и руководителей.",
     "Если отвечаешь по конкретным организациям, укажи источник в конце: слой, название и ИНН.",
+    options.schema === "json" ? "Верни валидный JSON без markdown-обертки." : "",
+    options.schema === "table" ? "Если уместно, верни ответ в виде markdown-таблицы." : "",
     "Отвечай кратко и по делу.",
-  ].join(" ");
+  ].filter(Boolean).join(" ");
   const contextText = JSON.stringify(dataContext, null, 2);
   const recentHistory = history.slice(-6);
 
@@ -1625,7 +2292,7 @@ async function callOpenAiCompatible(config, messages, apiKey, providerName) {
     body: JSON.stringify({
       model: config.model,
       messages,
-      temperature: 0.2,
+      temperature: Number(config.temperature ?? 0.2),
     }),
   });
 
@@ -1815,9 +2482,9 @@ async function setupClient(args) {
     throw new Error('Only "iola setup codex" is available in this first release.');
   }
 
-  console.log("Run:");
-  console.log("  codex mcp add yoshkarOlaPublicData --url https://apiiola.yasg.ru/mcp");
-  console.log("  npx -y @iola_adm/yoshkar-ola-public-mcp install-skill codex");
+  await runCommand("codex", ["mcp", "add", "yoshkarOlaPublicData", "--url", `${await getMcpBaseUrl()}/mcp`], { inherit: true });
+  await runCommand("npx", ["-y", "@iola_adm/yoshkar-ola-public-mcp", "install-skill", "codex"], { inherit: true });
+  console.log("Codex MCP и skill установлены.");
 }
 
 function parseOptions(args) {
@@ -1825,12 +2492,12 @@ 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" || arg === "--events" || arg === "--no-history" || arg === "--summary" || arg === "--all") {
       result[arg.slice(2)] = true;
     } 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") {
+    } 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" || arg === "--output" || arg === "--schema" || arg === "--session" || arg === "--temperature" || arg === "--config") {
       result[arg.slice(2)] = args[index + 1];
       index += 1;
     } else {