@iola_adm/iola-cli 0.2.34 → 0.2.36

package/wiki/Daemon-RPC-/320/270-cron.md

@@ -1,35 +1,53 @@
-# Daemon, RPC и cron
-
-Локальный daemon запускает HTTP/RPC endpoint на компьютере пользователя:
-
-```bash
-iola daemon status
-iola daemon start
-```
-
-По умолчанию endpoint:
-
-```text
-http://127.0.0.1:18790
-```
+# Daemon, RPC и cron
+
+Локальный daemon запускает HTTP/RPC endpoint на компьютере пользователя:
+
+```bash
+iola daemon status
+iola daemon start
+```
+
+По умолчанию endpoint:
+
+```text
+http://127.0.0.1:18790
+```
+
+RPC-команды:
+
+```bash
+iola rpc call status
+iola rpc call search --query Петрова --dataset schools
+iola rpc call card --query "школа 29"
+iola rpc call quality
+```
+
+Cron-задачи:
+
+```bash
+iola cron add "каждый день 09:00 -- quality"
+iola cron list
+iola cron run 1
+iola cron tick
+iola cron delete 1
+```
+
+`cron tick` проверяет задачи, которые пора выполнить. Его можно запускать вручную, через Windows Task Scheduler или другой планировщик.
 
-RPC-команды:
+## Готовые cron-сценарии Яндекса
 
 ```bash
-iola rpc call status
-iola rpc call search --query Петрова --dataset schools
-iola rpc call card --query "школа 29"
-iola rpc call quality
+iola yandex mail-watch on --minutes 5
+iola yandex daily-digest on --time 09:00
+iola yandex calendar-reminders on --minutes 15
+iola yandex contacts-maintenance on --days 7 --backup
+iola yandex disk-maintenance on --days 7
 ```
 
-Cron-задачи:
-
-```bash
-iola cron add "каждый день 09:00 -- quality"
-iola cron list
-iola cron run 1
-iola cron tick
-iola cron delete 1
-```
+- `mail-watch` проверяет новые письма.
+- `daily-digest` собирает сводку по почте, календарю и контактам, сохраняет Markdown-документ на Яндекс Диск.
+- `calendar-reminders` проверяет ближайшие события календаря.
+- `contacts-maintenance` ищет неполные карточки и дубликаты, опционально делает backup.
+- `disk-maintenance` проверяет место, документы и публичные ссылки в папке `/IOLA`, сохраняет отчет на Диск.
 
-`cron tick` проверяет задачи, которые пора выполнить. Его можно запускать вручную, через Windows Task Scheduler или другой планировщик.
+Чтобы расписания выполнялись автоматически, должен регулярно запускаться `iola cron tick`: вручную, через daemon или системный планировщик.

package/wiki/Skills-/320/270-toolsets.md

@@ -53,12 +53,27 @@ Skill - это инструкция для агента, а не произво
 
 - `user_skill_list` - список пользовательских skills;
 - `user_skill_create` - создать skill;
+- `user_skill_update` - обновить существующий skill;
+- `user_skill_templates` - показать готовые шаблоны;
+- `user_skill_preview` - показать будущий `SKILL.md` до записи;
+- `user_skill_validate` - проверить структуру и безопасность skill;
 - `user_skill_enable` - включить skill;
 - `user_skill_disable` - выключить skill;
 - `user_skill_delete` - удалить пользовательский skill.
 
 При создании через AI пользователь может написать обычным языком: `создай скилл, который при просьбе "сводка почты" берет непрочитанные письма и группирует по отправителям`. CLI создаст локальный `SKILL.md` и включит его.
 
+Команды:
+
+```bash
+iola skills templates
+iola skills preview family --template family-calendar
+iola skills create family --template family-calendar --enable
+iola skills validate family
+iola skills update family --instructions "..."
+iola skills delete family --yes
+```
+
 Для опасных действий внутри пользовательского skill нужно явное подтверждение пользователя: отправка писем, удаление данных, публикация ссылок, запись файлов и изменение внешних сервисов.
 
 ## Yandex toolset
@@ -68,8 +83,10 @@ Toolset `yandex` включает локальные tools для пользов
 - Yandex ID: профиль, логин, email;
 - Яндекс Диск: список, создание папок, поиск, сохранение текста, загрузка, скачивание, публичные ссылки;
 - Яндекс Почта: статус, список писем, поиск, чтение, отправка;
-- Яндекс Календарь: статус, список событий, создание события;
+- Яндекс Календарь: календари, список, поиск, создание, перенос, редактирование, повторы, напоминания, удаление событий;
+- Яндекс Документы / 360: работа через Яндекс Диск - список, поиск, создание текстовых документов, чтение, ссылка/QR, переименование, удаление;
 - Яндекс Контакты: статус, список, поиск, карточка, создание, обновление, удаление, импорт/экспорт, дубликаты, неполные карточки, backup на Диск, дни рождения в календарь, письмо/ссылка/встреча по контакту;
-- Телемост: подготовка встречи через календарное событие.
+- Комбинированные сценарии: пакет по письму, полный пакет по контакту, ежедневный дайджест, календарные напоминания, аудит Яндекс Диска;
+- Телемост: попытка прямого API и fallback через календарное событие, если API недоступен аккаунту.
 
-Опасные действия ограничены: отправка письма, удаление файлов, публикация ссылок и создание событий требуют явного подтверждения в tool-вызове. Токены хранятся локально в `~/.iola/secrets.json`.
+Опасные действия ограничены: отправка письма, удаление файлов, публикация ссылок, создание/изменение документов и создание/изменение/удаление событий требуют явного подтверждения в tool-вызове. Токены хранятся локально в `~/.iola/secrets.json`.

package/wiki/Yandex-Connector.md

@@ -143,8 +143,24 @@ QR-код:
 - `yandex_mail_read` - прочитать письмо по UID;
 - `yandex_mail_send` - отправить письмо;
 - `yandex_calendar_status` - проверить доступ к Календарю;
-- `yandex_calendar_list` - показать события;
-- `yandex_calendar_create_event` - создать событие;
+- `yandex_calendar_calendars` - показать доступные календари;
+- `yandex_calendar_list` - показать ближайшие события;
+- `yandex_calendar_search` - найти событие;
+- `yandex_calendar_get` - открыть карточку события;
+- `yandex_calendar_create_event` - создать событие с участниками, местом и напоминаниями;
+- `yandex_calendar_create_recurring_event` - создать повторяющееся событие;
+- `yandex_calendar_update` - изменить событие;
+- `yandex_calendar_move` - перенести событие;
+- `yandex_calendar_add_reminder` - добавить напоминание;
+- `yandex_calendar_delete` - удалить событие;
+- `yandex_docs_status` - проверить Документы / 360 через Диск;
+- `yandex_docs_list` - показать документы;
+- `yandex_docs_find` - найти документ;
+- `yandex_docs_create_text` - создать текстовый документ на Яндекс Диске;
+- `yandex_docs_read` - прочитать небольшой текстовый документ;
+- `yandex_docs_share` - создать ссылку и QR-код на документ;
+- `yandex_docs_rename` - переименовать документ;
+- `yandex_docs_delete` - удалить документ;
 - `yandex_contacts_status` - проверить доступ к Контактам;
 - `yandex_contacts_list` - показать контакты;
 - `yandex_contacts_search` - найти контакт по имени, email, телефону, организации, адресу или заметке;
@@ -166,7 +182,20 @@ QR-код:
 - `yandex_contact_create_calendar_event` - создать встречу с контактом;
 - `yandex_contact_create_telemost_event` - создать событие для Телемоста с контактом;
 - `yandex_contact_from_public_entity` - создать контакт из открытого городского слоя;
-- `yandex_telemost_create_event` - создать календарное событие для встречи.
+- `yandex_contact_full_pack` - собрать полный пакет по контакту: папка на Диске, заметка, публичная ссылка/QR, событие календаря и опциональное письмо;
+- `yandex_mail_meeting_pack` - собрать пакет по письму: сохранить письмо на Диск, создать ссылку/QR, поставить встречу в календарь и опционально отправить ссылку отправителю;
+- `yandex_telemost_status` - проверить режим Телемоста;
+- `yandex_telemost_create_event` - создать встречу: прямой Telemost API используется только если он доступен аккаунту; иначе создается календарное событие без выдуманной ссылки.
+
+Комбинированные сценарии:
+
+```bash
+iola ask "по последнему письму создай встречу завтра в 14:00, сохрани письмо на диск и пришли отправителю ссылку"
+iola ask "собери полный пакет по контакту Петров: папка на диске, заметка, встреча завтра в 12 и ссылка с QR"
+iola ask "создай папку для школы 2 на яндекс диске и отправь ссылку контакту Иванов"
+```
+
+CLI использует уже подключенные сервисы: Почту, Диск, Контакты и Календарь. Если не хватает email, найдено несколько контактов или неясна дата встречи, CLI должен уточнить, а не выбирать случайно.
 
 Регулярная проверка контактов:
 
@@ -180,6 +209,32 @@ iola yandex contacts-maintenance off
 
 Проверка ищет дубликаты и неполные карточки. Если включен `--backup`, при tick сохраняется CSV-копия контактов на Яндекс Диск.
 
+Регулярная автоматизация:
+
+```bash
+iola yandex daily-digest on --time 09:00
+iola yandex daily-digest on --time 09:00 --email
+iola yandex daily-digest status
+iola yandex daily-digest tick
+iola yandex daily-digest off
+
+iola yandex calendar-reminders on --minutes 15
+iola yandex calendar-reminders status
+iola yandex calendar-reminders tick
+iola yandex calendar-reminders off
+
+iola yandex disk-maintenance on --days 7
+iola yandex disk-maintenance status
+iola yandex disk-maintenance tick
+iola yandex disk-maintenance off
+```
+
+`daily-digest` собирает короткую сводку: непрочитанные письма, события ближайших суток и неполные контакты. По умолчанию сводка сохраняется документом в `/IOLA/docs`; с `--email` дополнительно отправляется на email подключенного Yandex ID.
+
+`calendar-reminders` проверяет события в ближайшие минуты и показывает напоминания без повторов по уже увиденным событиям.
+
+`disk-maintenance` проверяет место на Диске, публичные ссылки и состояние папки `/IOLA`, затем сохраняет отчет в `/IOLA/docs`.
+
 Включение сервиса в `/yandex` разрешает CLI использовать соответствующую категорию. Отправка письма, удаление файлов, публикация ссылок и создание событий требуют явного намерения пользователя и подтверждения в tool-вызове.
 
 ## Иконка приложения

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

@@ -233,7 +233,47 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 Работать с Яндекс Календарем:
 
 - показать ближайшие события;
-- создать событие только после явного подтверждения.
+- показать список календарей;
+- найти событие по названию, месту, описанию или дате;
+- создать событие только после явного подтверждения;
+- создать повторяющееся событие;
+- перенести встречу на новую дату или время;
+- изменить название, описание или место события;
+- добавить напоминание;
+- удалить событие по явной просьбе.
+
+Примеры:
+
+- `покажи яндекс календарь`;
+- `найди событие собрание в яндекс календаре`;
+- `создай событие название: прием врача завтра в 10:00`;
+- `перенеси встречу прием врача на послезавтра в 11:00`;
+- `добавь напоминание 20 минут к событию прием врача`;
+- `удали событие прием врача`.
+
+### yandex-docs
+
+Работать с документами Яндекс 360 через Яндекс Диск:
+
+- показать документы в папке `/IOLA/docs`;
+- найти документ по названию;
+- создать текстовый, Markdown или HTML-документ;
+- прочитать небольшой текстовый документ;
+- создать публичную ссылку и QR-код на документ;
+- переименовать документ;
+- удалить документ по явной просьбе.
+
+Важно: CLI работает с документами как с файлами на Яндекс Диске. Он не подменяет веб-редактор Яндекс Документов и не обещает создание "нативного" документа, если Яндекс не дает стабильный API для этого действия.
+
+Примеры:
+
+- `покажи документы на Яндекс Диске`;
+- `найди документ справка на Яндекс Диске`;
+- `создай документ яндекс 360 название: заметка текст: купить лекарства`;
+- `прочитай документ /IOLA/docs/заметка.md`;
+- `сделай ссылку на документ /IOLA/docs/заметка.md`;
+- `переименуй документ /IOLA/docs/заметка.md в лекарства.md`;
+- `удали документ /IOLA/docs/лекарства.md`.
 
 ### yandex-contacts
 
@@ -282,6 +322,7 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 - создать папку контакта на Яндекс Диске и сохранить туда `contact.vcf` и `README.txt`;
 - создать встречу с контактом в Яндекс Календаре;
 - создать календарное событие для Телемоста с контактом;
+- создать полный пакет контакта: папка на Диске, Markdown-документ, публичная ссылка, QR-код и встреча в календаре;
 - создать контакт из открытого городского слоя, если у школы или детского сада есть публичный email или телефон.
 
 Примеры:
@@ -289,12 +330,53 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 - `отправь Петрову письмо текст: встреча завтра в 14:00`;
 - `отправь Иванову ссылку и QR-код на /IOLA/report.pdf`;
 - `создай папку на Яндекс Диске для контакта Иван Петров`;
+- `подготовь полный пакет по контакту Иван Петров завтра в 15:00`;
 - `создай встречу с Иваном Петровым завтра в 15:00`;
 - `создай контакт из школы № 7`.
 
+### yandex-mail-combined
+
+Комбинированные сценарии по письмам:
+
+- сохранить письмо на Яндекс Диск в Markdown;
+- создать публичную ссылку и QR-код на сохраненное письмо;
+- создать событие календаря по письму;
+- пригласить отправителя письма как участника, если в отправителе есть email;
+- при явной просьбе отправить отправителю ссылку и QR-код.
+
+Примеры:
+
+- `по письму #2382 создай пакет: сохрани на диск, сделай ссылку и событие`;
+- `по самому свежему письму подготовь встречу завтра в 14:00`;
+- `сохрани письмо #2382 на Диск и создай событие`.
+
 ### yandex-telemost
 
-Подготовить встречу через календарное событие. CLI не должен сам нажимать финальные кнопки в интерфейсе Яндекса без явного действия пользователя.
+Подготовить встречу через Телемост:
+
+- проверить режим Телемоста;
+- попробовать создать ссылку через прямой API, если он доступен текущему аккаунту;
+- если прямой API недоступен, создать календарное событие и честно сообщить, что ссылка Телемоста не была получена через API.
+
+CLI не должен сам нажимать финальные кнопки в веб-интерфейсе Яндекса без явного действия пользователя и не должен выдумывать ссылку Телемоста.
+
+### yandex-automation
+
+Регулярные сценарии через локальный cron:
+
+- автоопрос новых писем;
+- ежедневный дайджест: непрочитанные письма, события на 24 часа, неполные контакты, сохранение отчета на Диск;
+- календарные напоминания: проверка ближайших событий;
+- регулярная проверка контактов: неполные карточки, дубликаты, backup;
+- аудит Яндекс Диска: место, корзина, документы и публичные ссылки в `/IOLA`.
+
+Команды:
+
+- `iola yandex mail-watch on --minutes 5`;
+- `iola yandex daily-digest on --time 09:00`;
+- `iola yandex calendar-reminders on --minutes 15`;
+- `iola yandex contacts-maintenance on --days 7 --backup`;
+- `iola yandex disk-maintenance on --days 7`.
 
 ## Yandex Connector backlog