@iola_adm/iola-cli 0.2.30 → 0.2.32

package/package.json

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

package/skills/yandex-services/SKILL.md

@@ -27,20 +27,33 @@ description: Сервисы Яндекса через Yandex Connector: ID, Ди
 - `yandex_mail_read` - прочитать письмо по UID; обычное чтение помечает письмо прочитанным.
 - `yandex_mail_send` - отправить письмо.
 - `yandex_mail_reply` - ответить на письмо по UID.
+- `yandex_mail_forward` - переслать письмо.
 - `yandex_mail_delete` - переместить письмо в корзину.
 - `yandex_mail_mark` - пометить письмо прочитанным или непрочитанным.
+- `yandex_mail_save_to_disk` - сохранить письмо на Яндекс Диск в Markdown.
+- `yandex_mail_create_calendar_event` - создать событие календаря из письма.
+- `yandex_mail_sender_to_contact` - добавить отправителя письма в контакты.
+- `yandex_mail_city_context` - найти в письме школы/детские сады/ИНН и подтянуть открытые городские слои.
+- `yandex_mail_map_addresses` - найти адреса в письме и дать ссылки на Яндекс.Карты.
+- `yandex_mail_create_task` - создать локальную задачу по письму.
+- Автоопрос почты включается командой `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_create` - создать новый контакт.
+- `yandex_contacts_add_email` - добавить email в существующий контакт.
 - `yandex_telemost_create_event` - создать календарное событие для встречи.
 
 Безопасность:
 
 - Для отправки письма, ответа на письмо, удаления письма, удаления файлов, публикации ссылки и создания событий нужен явный запрос пользователя и `confirm=true`.
-- Не отправляй письма, не отвечай на письма, не удаляй письма/файлы и не публикуй ссылки по косвенному намерению.
+- Для пересылки письма, создания контакта, создания события из письма и добавления отправителя в контакты также нужен явный запрос пользователя и `confirm=true`.
+- Не отправляй письма, не отвечай на письма, не пересылай письма, не создавай контакты/события, не удаляй письма/файлы и не публикуй ссылки по косвенному намерению.
 - Список писем и поиск не должны помечать письма прочитанными. Чтение письма по просьбе пользователя помечает письмо прочитанным.
+- Если пользователь просит отправить письмо по имени контакта, сначала ищи контакт. Если контактов несколько, покажи варианты и попроси уточнить. Если контакта нет или у него нет email, скажи прямо.
+- Если пользователь отправил письмо на введенный email и указал имя контакта, можно предложить добавить email в найденный контакт без email.
 - Не выводи OAuth-токены, API-ключи, пароли и секреты.
 - Если сервис не подключен, скажи запустить `iola yandex setup` или открыть `/master`.

package/src/cli.js

@@ -170,14 +170,23 @@ const YANDEX_TOOLS = [
   "yandex_mail_read",
   "yandex_mail_send",
   "yandex_mail_reply",
+  "yandex_mail_forward",
   "yandex_mail_delete",
   "yandex_mail_mark",
+  "yandex_mail_save_to_disk",
+  "yandex_mail_create_calendar_event",
+  "yandex_mail_sender_to_contact",
+  "yandex_mail_city_context",
+  "yandex_mail_map_addresses",
+  "yandex_mail_create_task",
   "yandex_calendar_status",
   "yandex_calendar_create_event",
   "yandex_calendar_list",
   "yandex_contacts_status",
   "yandex_contacts_list",
   "yandex_contacts_search",
+  "yandex_contacts_create",
+  "yandex_contacts_add_email",
   "yandex_telemost_create_event",
 ];
 const ALL_LOCAL_TOOLS = [...LOCAL_TOOLS, ...FILE_TOOLS, ...YANDEX_TOOLS];
@@ -3308,6 +3317,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 +3357,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 +3387,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();
@@ -3959,14 +4015,23 @@ async function executeYandexTool(tool, args = {}) {
   if (tool === "yandex_mail_read") return yandexMailRead(args.uid || args.id, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: args.markSeen !== false });
   if (tool === "yandex_mail_send") return yandexMailSend(args);
   if (tool === "yandex_mail_reply") return yandexMailReply(args);
+  if (tool === "yandex_mail_forward") return yandexMailForward(args);
   if (tool === "yandex_mail_delete") return yandexMailDelete(args.uid || args.id, { ...args, mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX") });
   if (tool === "yandex_mail_mark") return yandexMailMark(args.uid || args.id, args.seen !== false && args.unread !== true, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX") });
+  if (tool === "yandex_mail_save_to_disk") return yandexMailSaveToDisk(args.uid || args.id, args);
+  if (tool === "yandex_mail_create_calendar_event") return yandexMailCreateCalendarEvent(args.uid || args.id, args);
+  if (tool === "yandex_mail_sender_to_contact") return yandexMailSenderToContact(args.uid || args.id, args);
+  if (tool === "yandex_mail_city_context") return yandexMailCityContext(args.uid || args.id, args);
+  if (tool === "yandex_mail_map_addresses") return yandexMailMapAddresses(args.uid || args.id, args);
+  if (tool === "yandex_mail_create_task") return yandexMailCreateTask(args.uid || args.id, args);
   if (tool === "yandex_calendar_status") return yandexCalendarStatus();
   if (tool === "yandex_calendar_create_event") return yandexCalendarCreateEvent(args);
   if (tool === "yandex_calendar_list") return yandexCalendarList(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_create") return yandexContactsCreate(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 +4152,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();
@@ -4160,6 +4271,123 @@ async function yandexMailReply(args = {}) {
   return { ...result, replyToUid: Number(uid), originalFrom: original.from };
 }
 
+async function yandexMailForward(args = {}) {
+  if (!args.confirm) throw new Error("Для пересылки письма нужен аргумент confirm=true.");
+  const uid = args.uid || args.id;
+  const to = Array.isArray(args.to) ? args.to : String(args.to || "").split(/[;,]/).map((item) => item.trim()).filter(Boolean);
+  if (!uid) throw new Error("UID письма обязателен.");
+  if (!to.length) throw new Error("Получатель пересылки не указан.");
+  const original = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: true });
+  if (!original || original.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const text = [
+    args.text || args.comment || "",
+    "",
+    "---------- Пересланное письмо ----------",
+    `От: ${original.from || "-"}`,
+    `Дата: ${original.date || "-"}`,
+    `Тема: ${original.subject || "(без темы)"}`,
+    "",
+    original.snippet || "",
+  ].join("\n").trim();
+  return yandexMailSend({ to, subject: `Fwd: ${original.subject || "(без темы)"}`, text, confirm: true });
+}
+
+async function yandexMailSaveToDisk(uid, args = {}) {
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: args.markSeen !== false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const safeSubject = slugForFile(row.subject || `mail-${uid}`).slice(0, 80);
+  const remotePath = args.path || args.remotePath || `${CLOUD_DEFAULT_REMOTE_DIR}/Почта/mail-${uid}-${safeSubject}.md`;
+  const text = [
+    `# ${row.subject || "(без темы)"}`,
+    "",
+    `- UID: ${row.uid}`,
+    `- От: ${row.from || "-"}`,
+    `- Дата: ${row.date || "-"}`,
+    "",
+    row.snippet || "",
+  ].join("\n");
+  const saved = await yandexDiskSaveText(text, remotePath);
+  return { ...saved, uid: row.uid, subject: row.subject };
+}
+
+async function yandexMailCreateCalendarEvent(uid, args = {}) {
+  if (!args.confirm) throw new Error("Для создания события из письма нужен аргумент confirm=true.");
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: true });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const detected = extractDateTimeFromText(`${row.subject}\n${row.snippet}`);
+  const start = args.start || detected.start || new Date(Date.now() + 3600000).toISOString();
+  const end = args.end || detected.end || new Date(new Date(start).getTime() + 3600000).toISOString();
+  return yandexCalendarCreateEvent({
+    title: args.title || row.subject || `Письмо #${uid}`,
+    description: [`Создано из письма #${uid}.`, `От: ${row.from || "-"}`, "", row.snippet || ""].join("\n"),
+    location: args.location || detected.location || "",
+    start,
+    end,
+    confirm: true,
+  });
+}
+
+async function yandexMailSenderToContact(uid, args = {}) {
+  if (!args.confirm) throw new Error("Для добавления отправителя в контакты нужен аргумент confirm=true.");
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const email = extractEmailAddress(row.from);
+  const name = extractDisplayName(row.from) || email;
+  if (!email) throw new Error("В отправителе письма не найден email.");
+  return yandexContactsCreate({ name, email, confirm: true });
+}
+
+async function yandexMailCityContext(uid, args = {}) {
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const text = `${row.subject}\n${row.snippet}`;
+  const queries = extractEducationQueriesFromText(text);
+  const results = [];
+  for (const query of queries) {
+    results.push(...searchLocalRecords(query, { dataset: "all", limit: 5, fts: true }));
+  }
+  const unique = dedupeBy(results, (item) => `${item.dataset || ""}:${item.inn || item.name}`);
+  return unique.slice(0, Number(args.limit || 10)).map((item) => ({
+    name: item.name,
+    inn: item.inn,
+    address: item.address,
+    phone: item.phone,
+    email: item.email,
+    website: item.website,
+    dataset: item.dataset,
+  }));
+}
+
+async function yandexMailMapAddresses(uid, args = {}) {
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const addresses = extractLikelyAddresses(`${row.subject}\n${row.snippet}`).slice(0, Number(args.limit || 5));
+  const rows = [];
+  for (const address of addresses) {
+    const point = await geocodeCached(address).catch(() => null);
+    rows.push({
+      address,
+      resolved: point?.address || "",
+      map: point?.lat && point?.lon ? `https://yandex.ru/maps/?pt=${point.lon},${point.lat}&z=16&l=map` : "",
+    });
+  }
+  return rows;
+}
+
+async function yandexMailCreateTask(uid, args = {}) {
+  if (!uid) throw new Error("UID письма обязателен.");
+  const row = await yandexMailRead(uid, { mailbox: await resolveYandexMailbox(args.mailbox || args.folder || "INBOX"), markSeen: false });
+  if (!row || row.status === "not-found") throw new Error(`Письмо #${uid} не найдено.`);
+  const title = args.title || `Ответить/разобрать письмо #${uid}: ${row.subject || "(без темы)"}`;
+  const id = addTask(title, `ask "прочитай письмо #${uid}"`);
+  return { id, title, uid: Number(uid), status: "open" };
+}
+
 async function yandexMailSend(args = {}) {
   if (!args.confirm) throw new Error("Для отправки письма нужен аргумент confirm=true.");
   const to = Array.isArray(args.to) ? args.to : String(args.to || "").split(/[;,]/).map((item) => item.trim()).filter(Boolean);
@@ -4573,7 +4801,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 +4813,95 @@ 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 };
+}
+
+async function yandexContactsCreate(args = {}) {
+  if (!args.confirm) throw new Error("Для создания контакта нужен аргумент confirm=true.");
+  const name = String(args.name || args.email || "").trim();
+  const email = String(args.email || "").trim();
+  if (!name) throw new Error("Имя контакта обязательно.");
+  if (!email || !/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/iu.test(email)) throw new Error("Корректный email обязателен.");
+  const token = await requireYandexOAuthToken("organizer", "Яндекс Контакты");
+  const baseUrl = await yandexContactsBaseUrl(token);
+  const uid = `${randomUUID()}@iola-cli`;
+  const card = [
+    "BEGIN:VCARD",
+    "VERSION:3.0",
+    `UID:${uid}`,
+    `FN:${escapeVcardValue(name)}`,
+    `EMAIL;TYPE=INTERNET:${email}`,
+    "END:VCARD",
+    "",
+  ].join("\r\n");
+  await yandexDavRequest(new URL(`${encodeURIComponent(uid)}.vcf`, baseUrl).toString(), token, {
+    method: "PUT",
+    headers: { "content-type": "text/vcard; charset=utf-8" },
+    body: card,
+    timeout: 45000,
+  });
+  return { status: "created", name, email, uid };
+}
+
+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 escapeVcardValue(value) {
+  return String(value || "").replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/,/g, "\\,").replace(/;/g, "\\;");
+}
+
+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 +9590,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 +9619,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 +10175,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 "Папки Яндекс Почты не найдены.";
@@ -9844,6 +10204,51 @@ async function buildYandexDirectAnswer(question, history = []) {
         const result = await yandexMailReply({ ...reply, confirm: true });
         return `Ответ отправлен на письмо #${result.replyToUid}: ${result.to.join(", ")}. Тема: ${result.subject}.`;
       }
+      if (/(перешли|переслать|перешли\s+письмо|fwd|forward)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        const to = [...String(question || "").matchAll(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/giu)].map((match) => match[0]);
+        if (!uid || !to.length) return "Для пересылки укажите письмо и получателя. Пример: перешли письмо #2382 user@example.com.";
+        const result = await yandexMailForward({ uid, to, confirm: true });
+        return `Письмо переслано: ${result.to.join(", ")}. Тема: ${result.subject}.`;
+      }
+      if (/(сохрани|запиши).{0,60}(диск|яндекс.?диск|облак)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "Какое письмо сохранить на Диск? Укажите номер из списка или UID.";
+        const result = await yandexMailSaveToDisk(uid, { mailbox: extractYandexMailboxName(question) || "INBOX" });
+        return `Письмо #${uid} сохранено на Яндекс Диск: ${result.remote || result.path}.`;
+      }
+      if (/(создай|добавь).{0,40}(событи|встреч|календар)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "Из какого письма создать событие? Укажите номер из списка или UID.";
+        const result = await yandexMailCreateCalendarEvent(uid, { mailbox: extractYandexMailboxName(question) || "INBOX", confirm: true });
+        return `Событие создано в Яндекс Календаре: ${result.title || result.uid}.`;
+      }
+      if (/(добавь|создай|сохрани).{0,50}(отправител|автор|контакт)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "Из какого письма добавить отправителя в контакты? Укажите номер из списка или UID.";
+        const result = await yandexMailSenderToContact(uid, { mailbox: extractYandexMailboxName(question) || "INBOX", confirm: true });
+        return `Контакт создан: ${result.name}, ${result.email}.`;
+      }
+      if (/(школ|сад|детсад|инн|городск|сло[йи]|йошкар)/iu.test(normalized) && /(письм|письма|письме)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "По какому письму проверить городские слои? Укажите номер из списка или UID.";
+        const rows = await yandexMailCityContext(uid, { mailbox: extractYandexMailboxName(question) || "INBOX" });
+        if (!rows.length) return "В письме не нашел совпадений со слоями школ и детских садов.";
+        return ["Нашел в городских слоях:", ...rows.map((row, index) => `${index + 1}. ${row.name}${row.inn ? `, ИНН ${row.inn}` : ""}${row.address ? `, ${row.address}` : ""}`)].join("\n");
+      }
+      if (/(адрес|карт|гео|место|где)/iu.test(normalized) && /(письм|письма|письме)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "Из какого письма взять адрес? Укажите номер из списка или UID.";
+        const rows = await yandexMailMapAddresses(uid, { mailbox: extractYandexMailboxName(question) || "INBOX" });
+        if (!rows.length) return "В письме не нашел адресов для карты.";
+        return ["Адреса из письма:", ...rows.map((row, index) => `${index + 1}. ${row.resolved || row.address}${row.map ? `\n${row.map}` : ""}`)].join("\n");
+      }
+      if (/(создай|добавь).{0,30}(задач|напомин)/iu.test(normalized)) {
+        const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
+        if (!uid) return "По какому письму создать задачу? Укажите номер из списка или UID.";
+        const result = await yandexMailCreateTask(uid, { mailbox: extractYandexMailboxName(question) || "INBOX" });
+        return `Задача создана #${result.id}: ${result.title}.`;
+      }
       if (/(удали|удалить|перемести\s+в\s+корзин)/iu.test(normalized)) {
         const uid = resolveYandexMailUidFromQuestion(question, previousAssistantText);
         if (!uid) return "Какое письмо удалить? Укажите номер из списка или UID, например: удали письмо #2382.";
@@ -9861,11 +10266,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 +10328,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 +10467,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 +10475,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}` : ""}`;
 }
@@ -10051,6 +10518,79 @@ function formatYandexMailRead(row) {
   ].filter((line) => line !== "").join("\n");
 }
 
+function slugForFile(value) {
+  return String(value || "")
+    .toLocaleLowerCase("ru-RU")
+    .replace(/[^\p{L}\p{N}._-]+/gu, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "")
+    || "item";
+}
+
+function extractDisplayName(value) {
+  const text = decodeMimeHeader(String(value || "").trim());
+  return text.match(/^(.+?)\s*<[^<>]+>/u)?.[1]?.replace(/^["']|["']$/g, "").trim() || "";
+}
+
+function extractDateTimeFromText(value) {
+  const text = String(value || "").toLocaleLowerCase("ru-RU");
+  let date = null;
+  if (/завтра/u.test(text)) date = new Date(Date.now() + 86400000);
+  if (/послезавтра/u.test(text)) date = new Date(Date.now() + 2 * 86400000);
+  const explicit = text.match(/(\d{1,2})[.\-/](\d{1,2})(?:[.\-/](\d{2,4}))?/u);
+  if (explicit) {
+    const year = explicit[3] ? Number(explicit[3].length === 2 ? `20${explicit[3]}` : explicit[3]) : new Date().getFullYear();
+    date = new Date(year, Number(explicit[2]) - 1, Number(explicit[1]), 9, 0, 0);
+  }
+  const time = text.match(/(?:в\s*)?(\d{1,2})[:.](\d{2})/u) || text.match(/(?:в\s+)(\d{1,2})\s*(?:час|ч\b)?/u);
+  if (!date && time) date = new Date();
+  if (date && time) {
+    date.setHours(Number(time[1]), Number(time[2] || 0), 0, 0);
+  }
+  if (!date) return {};
+  const start = date.toISOString();
+  const end = new Date(date.getTime() + 3600000).toISOString();
+  const location = extractLikelyAddresses(value)[0] || "";
+  return { start, end, location };
+}
+
+function extractEducationQueriesFromText(value) {
+  const text = String(value || "");
+  const queries = [];
+  for (const match of text.matchAll(/(?:школ[ауыи]?|сош|гимнази[яи]|лице[йя])\s*№?\s*(\d{1,3})/giu)) queries.push(`школа ${match[1]}`);
+  for (const match of text.matchAll(/(?:детск\w*\s+сад|детсад|садик)\s*№?\s*(\d{1,3})/giu)) queries.push(`детский сад ${match[1]}`);
+  for (const match of text.matchAll(/\bинн\s*(\d{10,12})\b/giu)) queries.push(match[1]);
+  return [...new Set(queries)];
+}
+
+function extractLikelyAddresses(value) {
+  const text = String(value || "").replace(/\s+/g, " ");
+  const rows = [];
+  const patterns = [
+    /(?:адрес|по адресу|место)\s*:?\s*([^.!?\n]{8,120})/giu,
+    /((?:ул\.?|улица|проспект|пр-т|бульвар|пер\.?|переулок)\s+[^.!?\n,]{3,80}(?:,\s*(?:д\.?\s*)?\d+[а-яa-z]?)?)/giu,
+  ];
+  for (const pattern of patterns) {
+    for (const match of text.matchAll(pattern)) {
+      const address = String(match[1] || "").trim().replace(/[;,]+$/u, "");
+      if (address.length >= 8 && !/https?:|www\.|@/iu.test(address) && /(ул\.?|улица|проспект|пр-т|бульвар|пер\.?|переулок|дом|д\.|\d)/iu.test(address)) rows.push(address);
+    }
+  }
+  return [...new Set(rows)].slice(0, 10);
+}
+
+function dedupeBy(rows, keyFn) {
+  const seen = new Set();
+  const result = [];
+  for (const row of rows) {
+    const key = keyFn(row);
+    if (seen.has(key)) continue;
+    seen.add(key);
+    result.push(row);
+  }
+  return result;
+}
+
 async function buildCloudDirectAnswer(question) {
   if (!isCloudQuestion(question)) return "";
   const normalized = String(question || "").toLocaleLowerCase("ru-RU");
@@ -10660,8 +11200,8 @@ async function buildLocalToolPlan(question, providerConfig, options) {
     `Доступные tools: ${availableToolNames(options).join(", ")}.`,
     "Схема: {\"steps\":[{\"tool\":\"search_data\",\"args\":{\"dataset\":\"schools|kindergartens|all\",\"query\":\"text\",\"limit\":10}}]}",
     "Минимальные tools: search_data {dataset,query,limit}, get_card {query}, export_report {name,format,output}, file_read {path}, browser_open {url}.",
-    "Yandex tools: yandex_identity_me {}, yandex_disk_ls {path}, yandex_disk_mkdir {path}, yandex_disk_find {query,path}, yandex_disk_save_text {path,text}, yandex_mail_folders {}, yandex_mail_list {mailbox,limit,unread}, yandex_mail_search {mailbox,query}, yandex_mail_read {mailbox,uid}, yandex_mail_mark {mailbox,uid,seen}, yandex_calendar_list {start,end}, yandex_contacts_search {query}.",
-    "Опасные Yandex tools используй только при явной просьбе пользователя и с confirm=true: yandex_disk_share, yandex_disk_delete, yandex_mail_send, yandex_mail_reply, yandex_mail_delete, yandex_calendar_create_event, yandex_telemost_create_event.",
+    "Yandex tools: yandex_identity_me {}, yandex_disk_ls {path}, yandex_disk_mkdir {path}, yandex_disk_find {query,path}, yandex_disk_save_text {path,text}, yandex_mail_folders {}, yandex_mail_list {mailbox,limit,unread}, yandex_mail_search {mailbox,query}, yandex_mail_read {mailbox,uid}, yandex_mail_mark {mailbox,uid,seen}, yandex_mail_save_to_disk {uid,path}, yandex_mail_city_context {uid}, yandex_mail_map_addresses {uid}, yandex_mail_create_task {uid,title}, yandex_calendar_list {start,end}, yandex_contacts_search {query}.",
+    "Опасные Yandex tools используй только при явной просьбе пользователя и с confirm=true: yandex_disk_share, yandex_disk_delete, yandex_mail_send, yandex_mail_reply, yandex_mail_forward, yandex_mail_delete, yandex_mail_create_calendar_event, yandex_mail_sender_to_contact, yandex_contacts_create, yandex_contacts_add_email, yandex_calendar_create_event, yandex_telemost_create_event.",
     "MCP tools доступны как mcp:SERVER:TOOL, например mcp:iola-local:search.",
     "Для выгрузки CSV добавь export_report с format=csv и output, если пользователь назвал файл.",
     `Вопрос: ${question}`,

package/test/smoke-test.js

@@ -89,6 +89,18 @@ 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, "yandex_mail_save_to_disk", "Yandex mail should save messages to Yandex Disk");
+assertIncludes(cliSource, "yandex_mail_create_calendar_event", "Yandex mail should create calendar events from messages");
+assertIncludes(cliSource, "yandex_mail_city_context", "Yandex mail should connect messages with city data layers");
+assertIncludes(cliSource, "yandex_mail_map_addresses", "Yandex mail should map addresses from messages");
+assertIncludes(cliSource, "yandex_mail_create_task", "Yandex mail should create local tasks from messages");
+assertIncludes(cliSource, "yandex_mail_forward", "Yandex mail should support forwarding messages");
+assertIncludes(cliSource, "yandexContactsCreate", "Yandex contacts should support creating contacts");
 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

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