@iola_adm/iola-cli 0.2.30 → 0.2.31

package/package.json

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

package/skills/yandex-services/SKILL.md

@@ -29,12 +29,14 @@ description: Сервисы Яндекса через Yandex Connector: ID, Ди
 - `yandex_mail_reply` - ответить на письмо по UID.
 - `yandex_mail_delete` - переместить письмо в корзину.
 - `yandex_mail_mark` - пометить письмо прочитанным или непрочитанным.
+- Автоопрос почты включается командой `iola yandex mail-watch on --minutes 5`, выключается `iola yandex mail-watch off`, ручная проверка `iola yandex mail-watch tick`.
 - `yandex_calendar_status` - проверить доступ к Яндекс Календарю.
 - `yandex_calendar_list` - показать события.
 - `yandex_calendar_create_event` - создать событие.
 - `yandex_contacts_status` - проверить доступ к Яндекс Контактам.
 - `yandex_contacts_list` - показать контакты.
 - `yandex_contacts_search` - найти контакт.
+- `yandex_contacts_add_email` - добавить email в существующий контакт.
 - `yandex_telemost_create_event` - создать календарное событие для встречи.
 
 Безопасность:
@@ -42,5 +44,7 @@ description: Сервисы Яндекса через Yandex Connector: ID, Ди
 - Для отправки письма, ответа на письмо, удаления письма, удаления файлов, публикации ссылки и создания событий нужен явный запрос пользователя и `confirm=true`.
 - Не отправляй письма, не отвечай на письма, не удаляй письма/файлы и не публикуй ссылки по косвенному намерению.
 - Список писем и поиск не должны помечать письма прочитанными. Чтение письма по просьбе пользователя помечает письмо прочитанным.
+- Если пользователь просит отправить письмо по имени контакта, сначала ищи контакт. Если контактов несколько, покажи варианты и попроси уточнить. Если контакта нет или у него нет email, скажи прямо.
+- Если пользователь отправил письмо на введенный email и указал имя контакта, можно предложить добавить email в найденный контакт без email.
 - Не выводи OAuth-токены, API-ключи, пароли и секреты.
 - Если сервис не подключен, скажи запустить `iola yandex setup` или открыть `/master`.

package/src/cli.js

@@ -178,6 +178,7 @@ const YANDEX_TOOLS = [
   "yandex_contacts_status",
   "yandex_contacts_list",
   "yandex_contacts_search",
+  "yandex_contacts_add_email",
   "yandex_telemost_create_event",
 ];
 const ALL_LOCAL_TOOLS = [...LOCAL_TOOLS, ...FILE_TOOLS, ...YANDEX_TOOLS];
@@ -3308,6 +3309,11 @@ async function handleYandex(args) {
     return;
   }
 
+  if (action === "mail-watch" || action === "mailwatch" || action === "watch-mail") {
+    await handleYandexMailWatch([target, ...rest].filter(Boolean));
+    return;
+  }
+
   if (action === "enable" || action === "disable") {
     const services = [target, ...rest].filter((item) => item && !String(item).startsWith("--"));
     if (services.length === 0) throw new Error("Укажите сервисы. Пример: iola yandex enable disk mail calendar");
@@ -3343,6 +3349,7 @@ async function handleYandex(args) {
   iola yandex menu
   iola yandex status|doctor
   iola yandex services
+  iola yandex mail-watch on|off|status|tick [--minutes 5]
   iola yandex enable disk mail calendar
   iola yandex disable mail
   iola yandex oauth-url [disk mail calendar] [--client-id ID] [--open]
@@ -3372,6 +3379,47 @@ function printYandexServices(options = {}) {
   ]);
 }
 
+async function handleYandexMailWatch(args = []) {
+  const [action = "status", ...rest] = args;
+  const options = parseOptions(rest);
+  if (action === "on" || action === "enable" || action === "start" || action === "вкл") {
+    const minutes = Math.max(1, Number(options.minutes || options.interval || rest.find((item) => /^\d+$/u.test(String(item))) || 5));
+    const result = await yandexMailWatchEnable(minutes);
+    console.log(`Автопроверка новых писем включена: каждые ${minutes} минут. Текущий последний UID: ${result.lastUid || "-"}.`);
+    console.log("Для работы по расписанию должен запускаться cron tick: вручную, через daemon или Windows Task Scheduler.");
+    return;
+  }
+  if (action === "off" || action === "disable" || action === "stop" || action === "выкл") {
+    await yandexMailWatchDisable();
+    console.log("Автопроверка новых писем выключена.");
+    return;
+  }
+  if (action === "tick" || action === "run" || action === "check") {
+    const result = await yandexMailWatchTick(options);
+    if (!result.enabled) {
+      console.log("Автопроверка новых писем выключена.");
+    } else if (!result.newMessages.length) {
+      console.log("Новых писем нет.");
+    } else {
+      console.log(["Новые письма:", ...result.newMessages.map((row, index) => `${index + 1}. ${formatYandexMailSummary(row)}`)].join("\n"));
+    }
+    return;
+  }
+  if (action === "status" || action === "doctor") {
+    const config = await loadConfig();
+    const watch = config.yandex?.mailWatch || {};
+    printKeyValue({
+      enabled: watch.enabled ? "yes" : "no",
+      minutes: watch.minutes || "-",
+      mailbox: watch.mailbox || "INBOX",
+      lastUid: watch.lastUid || "-",
+      cron: listCronJobs().some((job) => job.command === "yandex mail-watch tick") ? "yes" : "no",
+    });
+    return;
+  }
+  throw new Error("Команды: iola yandex mail-watch on --minutes 5 | off | status | tick");
+}
+
 async function setupYandexConnector(args = []) {
   const options = parseOptions(args);
   const config = await loadConfig();
@@ -3967,6 +4015,7 @@ async function executeYandexTool(tool, args = {}) {
   if (tool === "yandex_contacts_status") return yandexContactsStatus();
   if (tool === "yandex_contacts_list") return yandexContactsList(args);
   if (tool === "yandex_contacts_search") return yandexContactsSearch(args.query || "", args);
+  if (tool === "yandex_contacts_add_email") return yandexContactsAddEmail(args.query || args.name || "", args.email, args);
   if (tool === "yandex_telemost_create_event") return yandexTelemostCreateEvent(args);
   throw new Error(`Yandex tool неизвестен: ${tool}`);
 }
@@ -4087,6 +4136,52 @@ async function yandexMailSearch(query, options = {}) {
   return rows.filter((row) => normalizeGeoText(`${row.from} ${row.subject} ${row.snippet}`).includes(normalized)).slice(0, Number(options.limit || 20));
 }
 
+async function yandexMailWatchTick(options = {}) {
+  const config = await loadConfig();
+  const watch = config.yandex?.mailWatch || {};
+  if (!watch.enabled && !options.force) return { enabled: false, newMessages: [] };
+  const mailbox = watch.mailbox || "INBOX";
+  const lastUid = Number(watch.lastUid || 0);
+  const rows = await yandexMailList({ mailbox, limit: Number(options.limit || 30), unread: false });
+  const newMessages = rows.filter((row) => Number(row.uid || 0) > lastUid).sort((left, right) => Number(left.uid || 0) - Number(right.uid || 0));
+  const newestUid = Math.max(lastUid, ...rows.map((row) => Number(row.uid || 0)));
+  await saveConfig({
+    yandex: {
+      ...(config.yandex || {}),
+      mailWatch: {
+        ...watch,
+        enabled: watch.enabled !== false,
+        mailbox,
+        lastUid: newestUid,
+        lastCheckedAt: new Date().toISOString(),
+      },
+    },
+  });
+  return { enabled: true, mailbox, lastUid, newestUid, newMessages };
+}
+
+async function yandexMailWatchEnable(minutes = 5) {
+  const config = await loadConfig();
+  const safeMinutes = Math.max(1, Number(minutes || 5));
+  const latest = await yandexMailList({ mailbox: "INBOX", limit: 1, unread: false });
+  const lastUid = latest[0]?.uid || 0;
+  await saveConfig({
+    yandex: {
+      ...(config.yandex || {}),
+      mailWatch: { enabled: true, minutes: safeMinutes, mailbox: "INBOX", lastUid, updatedAt: new Date().toISOString() },
+    },
+  });
+  await upsertCronJob(`каждые ${safeMinutes} минут`, "yandex mail-watch tick", { replaceCommand: true });
+  return { enabled: true, minutes: safeMinutes, mailbox: "INBOX", lastUid };
+}
+
+async function yandexMailWatchDisable() {
+  const config = await loadConfig();
+  await saveConfig({ yandex: { ...(config.yandex || {}), mailWatch: { ...(config.yandex?.mailWatch || {}), enabled: false, updatedAt: new Date().toISOString() } } });
+  deleteCronJobsByCommand("yandex mail-watch tick");
+  return { enabled: false };
+}
+
 async function yandexMailRead(uid, options = {}) {
   if (!uid) throw new Error("UID письма обязателен.");
   const { token, email } = await yandexMailCredentials();
@@ -4573,7 +4668,7 @@ async function yandexContactsList(args = {}) {
   const rows = [];
   for (const href of hrefs) {
     const card = await yandexDavRequest(new URL(href, "https://carddav.yandex.ru/").toString(), token, { method: "GET", timeout: 30000 }).catch(() => "");
-    rows.push(...parseVCards(card));
+    rows.push(...parseVCards(card).map((row) => args.full ? { ...row, href, card } : row));
   }
   return rows.slice(0, Number(args.limit || 50));
 }
@@ -4585,6 +4680,64 @@ async function yandexContactsSearch(query, args = {}) {
   return rows.filter((row) => normalizeGeoText(`${row.name} ${row.email} ${row.phone}`).includes(normalized)).slice(0, Number(args.limit || 20));
 }
 
+async function resolveYandexMailRecipientFromContacts(query) {
+  const normalized = normalizeContactLookupText(query);
+  if (!normalized) return { status: "not-found", contacts: [] };
+  const rows = await yandexContactsList({ limit: 300 });
+  const matches = rows.filter((row) => contactMatchesQuery(row, normalized)).slice(0, 10);
+  if (!matches.length) return { status: "not-found", contacts: [] };
+  const withEmail = matches.filter((row) => row.email);
+  if (withEmail.length === 1) return { status: "ok", contact: withEmail[0] };
+  if (withEmail.length > 1) return { status: "ambiguous", contacts: withEmail };
+  return matches.length === 1
+    ? { status: "no-email", contact: matches[0] }
+    : { status: "ambiguous", contacts: matches };
+}
+
+async function yandexContactsAddEmail(query, email, args = {}) {
+  if (!args.confirm) throw new Error("Для изменения контакта нужен аргумент confirm=true.");
+  if (!query) throw new Error("Укажите имя или часть имени контакта.");
+  if (!email || !/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/iu.test(String(email))) throw new Error("Укажите корректный email.");
+  const rows = await yandexContactsList({ limit: 500, full: true });
+  const matches = rows.filter((row) => contactMatchesQuery(row, normalizeContactLookupText(query))).slice(0, 10);
+  if (!matches.length) return { status: "not-found", query };
+  if (matches.length > 1 && !args.selectFirst) return { status: "ambiguous", query, contacts: matches.map(({ card, ...row }) => row) };
+  const contact = matches[0];
+  if (contact.email && !args.overwrite) return { status: "has-email", contact: { name: contact.name, email: contact.email } };
+  const updatedCard = upsertVcardEmail(contact.card, email, { overwrite: Boolean(args.overwrite) });
+  const token = await requireYandexOAuthToken("organizer", "Яндекс Контакты");
+  await yandexDavRequest(new URL(contact.href, "https://carddav.yandex.ru/").toString(), token, {
+    method: "PUT",
+    headers: { "content-type": "text/vcard; charset=utf-8" },
+    body: updatedCard,
+    timeout: 45000,
+  });
+  return { status: "updated", name: contact.name, email };
+}
+
+function upsertVcardEmail(card, email, options = {}) {
+  const text = String(card || "").replace(/\r/g, "").trim();
+  if (!text.includes("BEGIN:VCARD")) throw new Error("Контакт не похож на vCard.");
+  if (/^EMAIL[^:]*:/imu.test(text)) {
+    if (!options.overwrite) return text;
+    return text.replace(/^EMAIL[^:]*:[^\n]*/imu, `EMAIL;TYPE=INTERNET:${email}`);
+  }
+  return text.replace(/\nEND:VCARD/iu, `\nEMAIL;TYPE=INTERNET:${email}\nEND:VCARD`);
+}
+
+function contactMatchesQuery(contact, normalizedQuery) {
+  const contactText = normalizeContactLookupText(`${contact.name || ""} ${contact.email || ""}`);
+  if (!contactText || !normalizedQuery) return false;
+  if (contactText.includes(normalizedQuery)) return true;
+  const queryTokens = normalizedQuery.split(/\s+/u).filter(Boolean);
+  const contactTokens = contactText.split(/\s+/u).filter(Boolean);
+  return queryTokens.every((queryToken) => contactTokens.some((contactToken) => contactToken.startsWith(queryToken.slice(0, Math.max(4, Math.min(queryToken.length, 6)))) || queryToken.startsWith(contactToken.slice(0, Math.max(4, Math.min(contactToken.length, 6))))));
+}
+
+function normalizeContactLookupText(value) {
+  return normalizeGeoText(String(value || "").replace(/\b(?:кому|контакт|письмо|сообщение)\b/giu, " ")).trim();
+}
+
 async function yandexContactsBaseUrl(token) {
   const root = "https://carddav.yandex.ru/";
   const principalXml = await yandexDavRequest(root, token, {
@@ -9273,6 +9426,25 @@ function addCronJob(scheduleText, command) {
   }
 }
 
+async function upsertCronJob(scheduleText, command, options = {}) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    const existing = db.prepare("SELECT id FROM cron_jobs WHERE command = ? ORDER BY id DESC LIMIT 1").get(command);
+    if (existing?.id) {
+      db.prepare("UPDATE cron_jobs SET schedule_text = ?, enabled = 1 WHERE id = ?").run(scheduleText, existing.id);
+      return Number(existing.id);
+    }
+    if (options.replaceCommand) {
+      db.prepare("DELETE FROM cron_jobs WHERE command = ?").run(command);
+    }
+    const result = db.prepare("INSERT INTO cron_jobs(schedule_text, command) VALUES (?, ?)").run(scheduleText, command);
+    return Number(result.lastInsertRowid);
+  } finally {
+    db.close();
+  }
+}
+
 function deleteCronJob(id) {
   initDatabase();
   const db = openDatabase();
@@ -9283,6 +9455,16 @@ function deleteCronJob(id) {
   }
 }
 
+function deleteCronJobsByCommand(command) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    db.prepare("DELETE FROM cron_jobs WHERE command = ?").run(command);
+  } finally {
+    db.close();
+  }
+}
+
 function dueCronJobs() {
   initDatabase();
   const db = openDatabase();
@@ -9829,6 +10011,20 @@ async function buildYandexDirectAnswer(question, history = []) {
     }
 
     if (mailFollowup || /(почт|письм|email|e-mail|спам|чернов|отправлен|исходящ|корзин)/iu.test(normalized)) {
+      if (/(авто|автомат|кажд|период|монитор|следи|проверяй|проверку|режим)/iu.test(normalized) && /(включ|запусти|начни|поставь|создай)/iu.test(normalized)) {
+        const minutes = Number(String(question || "").match(/(\d+)\s*(?:мин|минут)/iu)?.[1] || 5);
+        await yandexMailWatchEnable(minutes);
+        return `Автопроверка новых писем включена: каждые ${minutes} минут.`;
+      }
+      if (/(авто|автомат|кажд|период|монитор|следи|проверяй|проверку|режим)/iu.test(normalized) && /(выключ|отключ|останов|убери)/iu.test(normalized)) {
+        await yandexMailWatchDisable();
+        return "Автопроверка новых писем выключена.";
+      }
+      if (/(проверь|получи|есть).{0,40}(нов|свеж)/iu.test(normalized)) {
+        const result = await yandexMailWatchTick({ force: true });
+        if (!result.newMessages.length) return "Новых писем нет.";
+        return ["Новые письма:", ...result.newMessages.map((row, index) => `${index + 1}. ${formatYandexMailSummary(row)}`)].join("\n");
+      }
       if (/(папк|ящик|mailbox|folder)/iu.test(normalized) && /(покажи|список|какие|есть)/iu.test(normalized)) {
         const folders = await yandexMailFolders();
         if (!folders.length) return "Папки Яндекс Почты не найдены.";
@@ -9861,11 +10057,34 @@ async function buildYandexDirectAnswer(question, history = []) {
       }
       if (/(отправь|отправить|напиши|пошли)/iu.test(normalized) && !/(отправлен|исходящ)/iu.test(normalized)) {
         const draft = parseYandexMailSendRequest(question);
+        if (!draft.to.length && draft.contactQuery) {
+          const contactResult = await resolveYandexMailRecipientFromContacts(draft.contactQuery);
+          if (contactResult.status === "not-found") return `В Яндекс Контактах не нашел: ${draft.contactQuery}. Укажите email вручную.`;
+          if (contactResult.status === "no-email") return `Контакт найден, но email не указан: ${contactResult.contact.name}. Укажите email вручную.`;
+          if (contactResult.status === "ambiguous") {
+            return [
+              `Нашел несколько контактов для "${draft.contactQuery}". Уточните, кому отправить:`,
+              ...contactResult.contacts.map((contact, index) => `${index + 1}. ${contact.name || contact.email || "Контакт"}${contact.email ? `, ${contact.email}` : ", email не указан"}`),
+            ].join("\n");
+          }
+          draft.to = [contactResult.contact.email];
+        }
         if (!draft.to.length || !draft.text) {
           return "Для отправки письма укажите получателя и текст. Пример: отправь письмо user@example.com тема: Привет текст: Проверка.";
         }
         const result = await yandexMailSend({ ...draft, confirm: true });
-        return `Письмо отправлено: ${result.to.join(", ")}. Тема: ${result.subject}.`;
+        let contactNote = "";
+        if (draft.contactQuery && result.to[0] && process.stdin.isTTY) {
+          const contactResult = await resolveYandexMailRecipientFromContacts(draft.contactQuery).catch(() => null);
+          if (contactResult?.status === "no-email") {
+            const shouldAdd = await askYesNo(`Добавить ${result.to[0]} в контакт "${contactResult.contact.name}"? [y/N] `, false);
+            if (shouldAdd) {
+              const update = await yandexContactsAddEmail(draft.contactQuery, result.to[0], { confirm: true, selectFirst: true });
+              contactNote = update.status === "updated" ? `\nEmail добавлен в контакт: ${update.name || draft.contactQuery}.` : "";
+            }
+          }
+        }
+        return `Письмо отправлено: ${result.to.join(", ")}. Тема: ${result.subject}.${contactNote}`;
       }
       if (/(сколько|количеств|есть\s+ли)/iu.test(normalized) && /непрочитан/iu.test(normalized)) {
         const mailbox = await resolveYandexMailbox(extractYandexMailboxName(question) || "INBOX");
@@ -9900,6 +10119,21 @@ async function buildYandexDirectAnswer(question, history = []) {
     }
 
     if (/(контакт|адресн)/iu.test(normalized)) {
+      if (/(добав|запиши|сохрани).{0,40}(email|e-mail|почт)/iu.test(normalized)) {
+        const email = String(question || "").match(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/iu)?.[0] || "";
+        const query = cleanupYandexContactEmailTarget(question, email);
+        if (!email || !query) return "Укажите контакт и email. Пример: добавь email petrov@example.com к контакту Петров.";
+        const result = await yandexContactsAddEmail(query, email, { confirm: true });
+        if (result.status === "not-found") return `Контакт не найден: ${query}.`;
+        if (result.status === "has-email") return `У контакта уже есть email: ${result.contact.name}, ${result.contact.email}.`;
+        if (result.status === "ambiguous") {
+          return [
+            `Нашел несколько контактов для "${query}". Уточните контакт:`,
+            ...result.contacts.map((contact, index) => `${index + 1}. ${contact.name || contact.email || "Контакт"}${contact.email ? `, ${contact.email}` : ""}`),
+          ].join("\n");
+        }
+        return `Email добавлен в контакт: ${result.name || query}, ${result.email}.`;
+      }
       if (/(статус|проверь|работает|доступ)/iu.test(normalized)) {
         const result = await yandexContactsStatus();
         return `Яндекс Контакты подключены: ${result.displayName || result.url}.`;
@@ -10024,6 +10258,7 @@ function parseYandexMailSendRequest(question) {
   const emails = [...text.matchAll(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/giu)].map((match) => match[0]);
   const subjectMatch = text.match(/(?:тема|subject)\s*:\s*(.*?)(?=\s+(?:текст|body|сообщение)\s*:|$)/iu);
   const bodyMatch = text.match(/(?:текст|body|сообщение)\s*:\s*(.*)$/iu);
+  const contactMatch = text.match(/^(?:отправь|отправить|напиши|пошли)\s+(.+?)(?:\s+письмо|\s+сообщение|\s+текст\s*:|\s+напомни|\s+скажи|$)/iu);
   const withoutCommand = text
     .replace(/^(?:отправь|отправить|напиши|пошли)\s+(?:письмо\s+)?/iu, "")
     .replace(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/giu, "")
@@ -10031,10 +10266,33 @@ function parseYandexMailSendRequest(question) {
   return {
     to: emails,
     subject: (subjectMatch?.[1] || "Сообщение от IOLA CLI").trim(),
-    text: (bodyMatch?.[1] || (!subjectMatch ? withoutCommand : "")).trim(),
+    text: (bodyMatch?.[1] || cleanupYandexMailBodyText(!subjectMatch ? withoutCommand : "")).trim(),
+    contactQuery: cleanupYandexContactQuery((contactMatch?.[1] || "").replace(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/giu, "")),
   };
 }
 
+function cleanupYandexMailBodyText(value) {
+  return String(value || "")
+    .replace(/^.+?\s+(?:письмо|сообщение)\s+/iu, "")
+    .trim();
+}
+
+function cleanupYandexContactQuery(value) {
+  return String(value || "")
+    .replace(/\b(?:письмо|сообщение|текст|напомни|скажи|ему|ей)\b/giu, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function cleanupYandexContactEmailTarget(question, email) {
+  return String(question || "")
+    .replace(email || "", " ")
+    .replace(/\b(?:добавь|добавить|запиши|сохрани|email|e-mail|почту|почта|к|ко|контакту|контакт)\b/giu, " ")
+    .replace(/[,:;.!?]+/gu, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
 function formatYandexMailSummary(row) {
   return `#${row.uid} ${row.subject || "(без темы)"}${row.from ? `, от ${row.from}` : ""}${row.date ? `, ${row.date}` : ""}`;
 }

package/test/smoke-test.js

@@ -89,6 +89,11 @@ assertIncludes(cliSource, "yandex_mail_delete", "Yandex mail should expose safe
 assertIncludes(cliSource, "yandex_mail_mark", "Yandex mail should expose read/unread mark as a tool");
 assertIncludes(cliSource, "decodeImapModifiedUtf7", "Yandex mail folders should decode IMAP modified UTF-7 names");
 assertIncludes(cliSource, "encodeImapModifiedUtf7", "Yandex mail should select non-ASCII folders via IMAP modified UTF-7");
+assertIncludes(cliSource, "yandexMailWatchEnable", "Yandex mail should support scheduled new-mail polling");
+assertIncludes(cliSource, "yandexMailWatchTick", "Yandex mail should support manual new-mail polling");
+assertIncludes(cliSource, "resolveYandexMailRecipientFromContacts", "Yandex mail should resolve recipients from contacts");
+assertIncludes(cliSource, "yandexContactsAddEmail", "Yandex contacts should support adding email to a contact");
+assertIncludes(cliSource, "yandex_contacts_add_email", "Yandex contacts add email should be exposed as a tool");
 assertIncludes(cliSource, "buildCasualDirectAnswer(question)", "Casual greetings should bypass external AI providers");
 assertNotIncludes(cliSource, "Сервисы через запятую [identity,disk]", "Yandex setup should not ask for services during connector setup");
 if (!packageJson.files.includes("docs/assets/iola-oauth-icon.png")) {

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

@@ -181,9 +181,18 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 - отправить письмо только после явного запроса;
 - ответить на письмо по UID или номеру из последнего списка;
 - удалить письмо безопасно: переместить его в корзину, а не стирать безвозвратно.
+- включить автоопрос новых писем, например каждые 5 минут;
+- выключить автоопрос новых писем;
+- вручную проверить новые письма через mail-watch tick;
+- отправить письмо по имени контакта из Яндекс Контактов;
+- если найдено несколько однофамильцев, попросить уточнить получателя;
+- если контакт найден, но email не указан, прямо сообщить об этом;
+- добавить email в существующий контакт по явной просьбе пользователя.
 
 Список писем и поиск не меняют статус письма. Статус меняется только при чтении письма, явной пометке или явном удалении.
 
+Автоопрос почты использует локальный cron CLI. Он не передает письма на сервер IOLA: токены, состояние последнего UID и расписание хранятся на компьютере пользователя.
+
 ### yandex-calendar
 
 Работать с Яндекс Календарем: