@iola_adm/iola-cli 0.2.7 → 0.2.9

package/README.md

@@ -179,6 +179,7 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 iola cloud setup yandex-disk
 iola cloud setup mailru-cloud
 iola cloud status
+iola cloud mkdir /IOLA/Фото
 iola cloud find "справка" --path /IOLA
 iola cloud upload report.md /IOLA/reports/report.md
 iola cloud share /IOLA/reports/report.md

package/package.json

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

package/skills/personal-docs/SKILL.md

@@ -12,6 +12,7 @@ description: Личные документы пользователя в обл
 Основные сценарии:
 
 - `cloud-find-document` - найти документ в подключенном облаке.
+- `cloud-create-folder` - создать папку на подключенном облачном диске.
 - `cloud-save-result` - сохранить ответ, отчет, карточку или список в облако.
 - `cloud-share-link` - создать публичную ссылку на файл в Яндекс Диске.
 - `cloud-document-pack` - собрать папку с материалами для обращения.

package/src/cli.js

@@ -2948,6 +2948,14 @@ async function handleCloud(args) {
     return;
   }
 
+  if (action === "mkdir" || action === "create-folder") {
+    const provider = await getCloudProvider(options.provider);
+    const remotePath = target || `${cloudRootForProvider(provider)}/Новая папка`;
+    const result = await cloudCreateFolder(provider, remotePath);
+    printKeyValue(result);
+    return;
+  }
+
   if (action === "upload") {
     if (!target) throw new Error('Пример: iola cloud upload report.md /IOLA/reports/report.md');
     const provider = await getCloudProvider(options.provider);
@@ -3004,6 +3012,7 @@ async function handleCloud(args) {
   iola cloud status|doctor
   iola cloud use yandex-disk
   iola cloud ls /IOLA
+  iola cloud mkdir /IOLA/Фото
   iola cloud find "справка" --path /IOLA
   iola cloud upload local.txt /IOLA/local.txt
   iola cloud download /IOLA/local.txt ./local.txt
@@ -3116,6 +3125,18 @@ async function cloudFind(provider, query, options = {}) {
   throw new Error(`Провайдер не поддерживается: ${provider}`);
 }
 
+async function cloudCreateFolder(provider, remotePath) {
+  if (provider === "yandex-disk") {
+    await ensureYandexDiskDir(remotePath, { allowExisting: true });
+    return { provider, path: normalizeYandexDiskPath(remotePath), status: "created-or-exists" };
+  }
+  if (provider === "mailru-cloud") {
+    await ensureMailruCloudDir(remotePath);
+    return { provider, path: remotePath, status: "created-or-exists" };
+  }
+  throw new Error(`Провайдер не поддерживается: ${provider}`);
+}
+
 async function cloudShare(provider, remotePath) {
   if (provider === "yandex-disk") return yandexDiskShare(remotePath);
   throw new Error("Публичные ссылки через CLI сейчас поддерживаются только для Яндекс Диска.");
@@ -3159,19 +3180,31 @@ async function yandexDiskList(remotePath, options = {}) {
 }
 
 async function yandexDiskFind(query, options = {}) {
-  const payload = await yandexDiskRequest("GET", "/resources/files", { query: { limit: Math.max(100, Number(options.limit || 50) * 5), fields: "items.name,items.path,items.size,items.type" } });
   const needle = normalizeGeoText(query);
-  return (payload.items || [])
-    .map((item) => ({
-      type: item.type === "dir" ? "dir" : "file",
-      name: item.name || path.basename(item.path || ""),
-      path: denormalizeYandexDiskPath(item.path || ""),
-      size: item.size || "-",
-    }))
+  const rows = await yandexDiskListRecursive(options.path || CLOUD_DEFAULT_REMOTE_DIR, { depth: Number(options.depth || 4), limit: Math.max(100, Number(options.limit || 50) * 5) });
+  return rows
     .filter((item) => normalizeGeoText(`${item.name} ${item.path}`).includes(needle))
     .slice(0, Number(options.limit || 50));
 }
 
+async function yandexDiskListRecursive(remotePath, options = {}) {
+  const depth = Number(options.depth || 4);
+  const limit = Number(options.limit || 200);
+  const rows = [];
+  await yandexDiskWalk(remotePath, rows, depth, limit);
+  return rows;
+}
+
+async function yandexDiskWalk(remotePath, rows, depth, limit) {
+  if (rows.length >= limit || depth < 0) return;
+  const items = await yandexDiskList(remotePath).catch(() => []);
+  for (const item of items) {
+    if (rows.length >= limit) break;
+    rows.push(item);
+    if (item.type === "dir") await yandexDiskWalk(item.path, rows, depth - 1, limit);
+  }
+}
+
 async function yandexDiskUpload(localPath, remotePath, options = {}) {
   const resolved = path.resolve(localPath);
   const info = await stat(resolved);
@@ -7861,6 +7894,20 @@ async function aiAsk(args, context = {}) {
   const historyEnabled = !options.bare && !options["no-history"] && isFeatureEnabled("sqlite-history");
   const sessionId = historyEnabled && isFeatureEnabled("sessions") ? ensureSessionForAsk(options, providerConfig, question) : null;
   const history = context.history || (sessionId ? getSessionAiHistory(sessionId) : []);
+  const cloudAnswer = await buildCloudDirectAnswer(question);
+  if (cloudAnswer) {
+    if (historyEnabled) {
+      recordAskHistory({ question, answer: cloudAnswer, providerConfig, dataContext, error: "", sessionId });
+      appendSessionExchange(sessionId, question, cloudAnswer, dataContext, "");
+    }
+    emitEvent(options, "answer", { length: cloudAnswer.length, sessionId, direct: true, cloud: true });
+    if (options.output) {
+      await assertPermission("writeFiles");
+      await writeFile(options.output, cloudAnswer, "utf8");
+    }
+    if (!options.quiet) console.log(cloudAnswer);
+    return cloudAnswer;
+  }
   const geoAnswer = await buildGeoDirectAnswer(question);
   if (geoAnswer) {
     if (historyEnabled) {
@@ -7961,6 +8008,119 @@ async function buildDirectDataAnswer(question, dataContext) {
   ].join("\n");
 }
 
+async function buildCloudDirectAnswer(question) {
+  if (!isCloudQuestion(question)) return "";
+  const normalized = String(question || "").toLocaleLowerCase("ru-RU");
+  try {
+    const provider = await getCloudProvider();
+    if (/(созда|сдела|добав).{0,30}(папк|директор)/iu.test(normalized) || /(папк|директор).{0,30}(созда|сдела|добав)/iu.test(normalized)) {
+      const folderName = extractCloudFolderName(question) || "Новая папка";
+      const remotePath = normalizeCloudUserPath(folderName, provider);
+      const result = await cloudCreateFolder(provider, remotePath);
+      return `Папка создана или уже была на облачном диске: ${result.path}`;
+    }
+
+    if (/(покажи|список|что.+лежит|файлы|папки)/iu.test(normalized)) {
+      const remotePath = extractCloudPath(question) || cloudRootForProvider(provider);
+      const rows = await cloudList(provider, normalizeCloudUserPath(remotePath, provider));
+      if (rows.length === 0) return `В папке ${normalizeCloudUserPath(remotePath, provider)} нет данных.`;
+      return [
+        `Облачный диск ${provider}, папка ${normalizeCloudUserPath(remotePath, provider)}:`,
+        ...rows.slice(0, 20).map((row, index) => `${index + 1}. ${row.type === "dir" ? "папка" : "файл"} ${row.name} — ${row.path}`),
+      ].join("\n");
+    }
+
+    if (/(найди|поиск|где лежит)/iu.test(normalized)) {
+      const query = cleanupCloudQuery(question);
+      const rows = await cloudFind(provider, query, { path: cloudRootForProvider(provider), limit: 10 });
+      if (rows.length === 0) return `На облачном диске не нашел: ${query}`;
+      return [
+        `Нашел на облачном диске ${provider}:`,
+        ...rows.map((row, index) => `${index + 1}. ${row.name} — ${row.path}`),
+      ].join("\n");
+    }
+
+    if (/(ссылк|поделись|опубликуй)/iu.test(normalized)) {
+      const remotePath = extractCloudPath(question);
+      if (!remotePath) return "Укажите путь к файлу на облачном диске, например: /IOLA/reports/report.md";
+      const result = await cloudShare(provider, normalizeCloudUserPath(remotePath, provider));
+      return `Публичная ссылка: ${result.publicUrl}`;
+    }
+
+    if (/(сохрани|запиши).{0,40}(на яндекс диске|в облак|на диск)/iu.test(normalized)) {
+      const text = cleanupCloudSaveText(question);
+      if (!text) return "Что сохранить на облачный диск?";
+      const remotePath = `${cloudRootForProvider(provider)}/notes/iola-${timestampForFile()}.txt`;
+      const tempPath = path.join(CONFIG_DIR, `cloud-save-${Date.now()}.txt`);
+      await mkdir(CONFIG_DIR, { recursive: true });
+      await writeFile(tempPath, text, "utf8");
+      try {
+        await cloudUpload(provider, tempPath, remotePath, { overwrite: true });
+      } finally {
+        await rm(tempPath, { force: true }).catch(() => {});
+      }
+      return `Сохранил текст на облачный диск: ${remotePath}`;
+    }
+  } catch (error) {
+    return `Не смог выполнить облачный запрос: ${error instanceof Error ? error.message : String(error)}`;
+  }
+  return "";
+}
+
+function isCloudQuestion(question) {
+  return /(яндекс.?диск|yandex.?disk|облак|облачн|на диск|с диска|в диск|cloud|mail\.?ru|публичн.*ссылк|поделиться.*файл)/iu.test(String(question || ""));
+}
+
+function normalizeCloudUserPath(value, provider = "yandex-disk") {
+  const root = cloudRootForProvider(provider);
+  let text = String(value || "").trim().replace(/\\/g, "/");
+  text = text.replace(/^["'«»]+|["'«»]+$/gu, "").trim();
+  if (!text) return root;
+  if (text.startsWith("/")) return text;
+  if (normalizeGeoText(text).startsWith(normalizeGeoText(root).replace(/^\//u, ""))) return `/${text.replace(/^\/+/u, "")}`;
+  return `${root.replace(/\/+$/u, "")}/${text.replace(/^\/+/u, "")}`;
+}
+
+function extractCloudFolderName(question) {
+  const text = String(question || "").trim();
+  const match = text.match(/(?:папк[ауи]?|директор(?:ию|ия|ии)?)\s+["'«]?([^"'».,!?]+)["'»]?/iu)
+    || text.match(/(?:названи(?:ем|е)|имя)\s+["'«]?([^"'».,!?]+)["'»]?/iu);
+  if (!match?.[1]) return "";
+  return cleanupCloudObjectName(match[1]);
+}
+
+function extractCloudPath(question) {
+  const text = String(question || "").trim();
+  const pathMatch = text.match(/(?:^|\s)(\/IOLA\/[^\s]+|\/[^\s]+)/iu);
+  if (pathMatch?.[1]) return pathMatch[1];
+  const quoted = text.match(/["«]([^"»]+)["»]/u);
+  if (quoted?.[1]) return quoted[1];
+  const afterFolder = text.match(/(?:папк[аеуы]?|файл[ае]?)\s+([^,.!?]+)/iu);
+  return afterFolder?.[1] ? cleanupCloudObjectName(afterFolder[1]) : "";
+}
+
+function cleanupCloudObjectName(value) {
+  return String(value || "")
+    .replace(/\b(?:на|в|у меня|яндекс.?диск(?:е)?|диск(?:е)?|облак(?:е|о)?|создай|сделай|добавь|покажи)\b/giu, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function cleanupCloudQuery(question) {
+  return String(question || "")
+    .replace(/\b(?:найди|поиск|где лежит|на|в|яндекс.?диск(?:е)?|облак(?:е|о)?|диск(?:е)?|файл|документ)\b/giu, " ")
+    .replace(/[?.!]+$/u, "")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function cleanupCloudSaveText(question) {
+  return String(question || "")
+    .replace(/^.*?(?:сохрани|запиши)\s+/iu, "")
+    .replace(/\s+(?:на яндекс диске|в облак[ео]|на диск).*$/iu, "")
+    .trim();
+}
+
 function detectDirectDataFields(normalizedQuestion) {
   const fields = [];
   if (/(директ|руководител|заведующ|кто возглавляет)/iu.test(normalizedQuestion)) fields.push("head");
@@ -8244,6 +8404,11 @@ async function localToolAsk(question, providerConfig, options) {
     if (!options.quiet) console.log(casualAnswer);
     return casualAnswer;
   }
+  const cloudAnswer = await buildCloudDirectAnswer(question);
+  if (cloudAnswer) {
+    if (!options.quiet) console.log(cloudAnswer);
+    return cloudAnswer;
+  }
   const geoAnswer = await buildGeoDirectAnswer(question);
   if (geoAnswer) {
     if (!options.quiet) console.log(geoAnswer);
@@ -10797,8 +10962,10 @@ function selectSkillsForPrompt(config, question = "", options = {}) {
   if (enabled.has("local-model")) selected.add("local-model");
   if (enabled.has("open-data") && shouldUseDataContext(question, options)) selected.add("open-data");
   if (enabled.has("geo") && isGeoQuestion(normalized)) selected.add("geo");
+  const cloudQuestion = isCloudQuestion(normalized);
+  if (enabled.has("personal-docs") && cloudQuestion) selected.add("personal-docs");
   if (enabled.has("reports") && /(отчет|отчёт|выгруз|csv|xlsx|качество|провер)/iu.test(normalized)) selected.add("reports");
-  if (enabled.has("local-files") && (options.files || /(файл|папк|readme|документ|архив)/iu.test(normalized))) selected.add("local-files");
+  if (enabled.has("local-files") && !cloudQuestion && (options.files || /(файл|папк|readme|документ|архив)/iu.test(normalized))) selected.add("local-files");
   if (enabled.has("browser-agent") && /(браузер|сайт|страниц|url|https?:\/\/)/iu.test(normalized)) selected.add("browser-agent");
   return selected;
 }

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

@@ -50,6 +50,7 @@ iola cloud status
 iola cloud doctor
 iola cloud use yandex-disk
 iola cloud ls /IOLA
+iola cloud mkdir /IOLA/Фото
 iola cloud find "справка" --path /IOLA
 iola cloud upload report.md /IOLA/reports/report.md
 iola cloud download /IOLA/reports/report.md ./report.md

package/wiki//320/236/320/261/320/273/320/260/321/207/320/275/321/213/320/265-/320/264/320/270/321/201/320/272/320/270.md

@@ -18,6 +18,7 @@ iola cloud status
 iola cloud doctor
 iola cloud use yandex-disk
 iola cloud ls /IOLA
+iola cloud mkdir /IOLA/Фото
 iola cloud find "справка" --path /IOLA
 iola cloud upload report.md /IOLA/reports/report.md
 iola cloud download /IOLA/reports/report.md ./report.md
@@ -36,20 +37,60 @@ iola cloud backup
 - получение OAuth-токена: `https://yandex.ru/dev/id/doc/ru/access`
 - получение токена вручную для проверки: `https://yandex.ru/dev/id/doc/ru/tokens/debug-token`
 
-Что сделать:
+### Получение OAuth-токена Яндекс Диска
 
 1. Откройте страницу Яндекс OAuth: `https://oauth.yandex.ru/`.
-2. Создайте приложение для личного использования.
-3. В правах приложения выберите доступ к Яндекс Диску.
-4. Получите OAuth-токен.
-5. В CLI выполните:
+2. Если Яндекс просит пройти верификацию через Госуслуги, пройдите ее. Без этого создание OAuth-приложения может быть недоступно.
+3. Нажмите `Создать`.
+4. В окне `Какое приложение хотите создать?` выберите `Для авторизации пользователей`.
+5. Нажмите `Перейти к созданию`.
+6. На шаге `Создание приложения` заполните:
+   - `Название вашего сервиса`: например `iola-cli`;
+   - `Иконка сервиса`: загрузите PNG-иконку до 1 МБ. Готовая иконка iola-cli доступна по ссылке: `https://raw.githubusercontent.com/adm-iola/iola-cli/main/docs/assets/iola-oauth-icon.png`;
+   - `Почта для связи`: оставьте свою почту или укажите актуальную.
+7. Нажмите `Продолжить`.
+8. На шаге `Платформы приложений` выберите `Веб-сервисы`.
+9. В поле `Redirect URI` укажите:
+
+```text
+https://oauth.yandex.ru/verification_code
+```
+
+10. Нажмите кнопку добавления рядом с `Redirect URI`, если интерфейс показывает такую кнопку.
+11. В поле `Suggest Hostname`, если оно обязательно, укажите сайт проекта или любой понятный URL сервиса, например:
+
+```text
+https://github.com
+```
+
+12. Нажмите `Продолжить`.
+13. На шаге `Права доступа к данным пользователей` не выбирайте лишние основные права: телефон, почта, дата рождения, профиль не нужны.
+14. В блоке `Дополнительные` через поле `Название доступа` добавьте три права:
+   - `Чтение всего Диска` / `cloud_api:disk.read`;
+   - `Запись в любом месте на Диске` / `cloud_api:disk.write`;
+   - `Доступ к информации о Диске` / `cloud_api:disk.info`.
+15. Нажмите `Продолжить`.
+16. На финальном экране проверьте, что приложение запрашивает только три права Диска.
+17. Нажмите `Всё верно, создать приложение`.
+18. На странице созданного приложения скопируйте `ClientID`.
+19. Откройте ссылку, заменив `CLIENT_ID` на ваш `ClientID`:
+
+```text
+https://oauth.yandex.ru/authorize?response_type=token&client_id=CLIENT_ID
+```
+
+20. На экране авторизации нажмите `Войти как ...`.
+21. Если Яндекс показывает предупреждение `Сервис ещё не верифицирован`, это нормально для личного приложения. Продолжайте только если приложение создавали вы сами и доверяете ему.
+22. Яндекс перенаправит на страницу `verification_code`, где будет показан OAuth-токен. В адресной строке он также находится после `access_token=`.
+23. Скопируйте OAuth-токен.
+24. В CLI выполните:
 
 ```bash
 iola cloud setup yandex-disk
 ```
 
-6. Вставьте OAuth-токен.
-7. Проверьте подключение:
+25. Вставьте OAuth-токен.
+26. Проверьте подключение:
 
 ```bash
 iola cloud doctor
@@ -57,6 +98,20 @@ iola cloud doctor
 
 Секрет сохраняется локально в `~/.iola/secrets.json`.
 
+После успешной проверки CLI создаст или использует папку `/IOLA` на Яндекс Диске.
+
+Обычно такой токен выдается на длительный срок. Если доступ перестал работать, получите новый токен через ту же ссылку авторизации и повторите `iola cloud setup yandex-disk`.
+
+После подключения можно работать с облаком обычными фразами в CLI:
+
+```text
+создай у меня на яндекс диске папку фото
+покажи что лежит на яндекс диске
+найди на яндекс диске справку
+```
+
+Такие запросы обрабатывает skill `personal-docs`. Они не требуют включать локальный режим `iola files mode`, потому что это не работа с файлами на ПК.
+
 ## Облако Mail.ru
 
 Облако Mail.ru подключается через WebDAV.

package/wiki//320/241/320/272/320/270/320/273/320/273/321/213-/320/264/320/273/321/217-/320/266/320/270/321/202/320/265/320/273/320/265/320/271.md

@@ -114,6 +114,15 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 
 Сохранить ответ CLI, отчет, карточку учреждения или список ближайших объектов в `/IOLA`.
 
+### cloud-create-folder
+
+Создать папку на подключенном облачном диске.
+
+Пример:
+
+- `создай у меня на яндекс диске папку фото`;
+- `создай папку документы в облаке`.
+
 ### cloud-share-link
 
 Создать публичную ссылку на файл. В первом контуре поддерживается для Яндекс Диска.