@iola_adm/iola-cli 0.2.35 → 0.2.37

package/wiki/AI-/320/277/321/200/320/276/321/204/320/270/320/273/320/270.md

@@ -29,7 +29,15 @@ iola ask "найди школы на Петрова"
 
 ### YandexGPT
 
-Для CLI нужны две вещи: API key и ID каталога Yandex Cloud.
+Рекомендуемый путь - через `Yandex Cloud Connector`:
+
+```bash
+iola yandex cloud setup
+```
+
+В интерактивном агенте можно выбрать YandexGPT через `/model`. Если Cloud Connector еще не подключен, CLI предложит открыть настройку.
+
+Для CLI нужны две вещи: API key и ID каталога Yandex Cloud. Тот же мастер Cloud Connector может дополнительно сохранить ключ геокодера, чтобы geo-skills и Яндекс Go deeplink работали сразу.
 
 Пошаговая настройка:
 
@@ -73,6 +81,7 @@ CLI попросит ввести:
 После сохранения ключа выберите профиль и модель:
 
 ```bash
+iola yandex cloud enable yandexgpt
 iola ai setup yandexgpt --model yandexgpt-lite/latest
 ```
 
@@ -92,6 +101,8 @@ iola ai setup yandexgpt --model yandexgpt-lite/latest
 
 CLI также понимает env-переменные `YANDEXGPT_API_KEY` или `YANDEX_CLOUD_API_KEY`, а для каталога - `YANDEXGPT_FOLDER_ID` или `YANDEX_CLOUD_FOLDER_ID`.
 
+Подробно про единый путь геокодера и YandexGPT: [Yandex Cloud Connector](Yandex-Cloud-Connector).
+
 ### GigaChat
 
 Для CLI нужен authorization key. Это не одноразовый OAuth access token: CLI сам получает OAuth-токен перед запросом, используя сохраненный authorization key.

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/Home.md

@@ -13,6 +13,7 @@
 - работа с YandexGPT, GigaChat, OpenAI, OpenRouter и Codex CLI;
 - geo-сценарии для жителей через Yandex Geocoder API;
 - Yandex Connector для пользовательских сервисов Яндекса;
+- Yandex Cloud Connector для геокодера, YandexGPT и deeplink Яндекс Go;
 - личные облачные диски: Яндекс Диск и Облако Mail.ru;
 - подключение публичного MCP-сервера.
 
@@ -32,6 +33,7 @@ iola ask "найди школу 29"
 - [Мастер настройки](Мастер-настройки)
 - [AI-профили](AI-профили)
 - [Yandex Geocoder API key](Yandex-Geocoder-API-key)
+- [Yandex Cloud Connector](Yandex-Cloud-Connector)
 - [Yandex Connector](Yandex-Connector)
 - [Облачные диски](Облачные-диски)
 - [Скиллы для жителей](Скиллы-для-жителей)

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

@@ -9,7 +9,7 @@ Skills не подмешиваются в каждый запрос целико
 - `local-files` - когда пользователь просит работать с локальными файлами, папками, архивами или документами;
 - `browser-agent` - когда запрос связан с сайтом, URL, страницей, скриншотом или браузером;
 - `local-model` - инструкции для локальных компактных моделей и tool-планирования;
-- `yandex-services` - когда запрос связан с Yandex Connector: Яндекс Диск, Почта, Календарь, Контакты, Телемост или Yandex ID;
+- `yandex-services` - когда запрос связан с Yandex Connector или Yandex Cloud Connector: Яндекс Диск, Почта, Календарь, Контакты, Телемост, Yandex ID, геокодер, YandexGPT или Яндекс Go deeplink;
 - `user-skills` - когда пользователь просит создать, включить, выключить или удалить собственный skill.
 
 Обычный диалог вроде `привет` не получает инструкции про слои, отчеты, файлы и браузер.
@@ -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
@@ -71,6 +86,7 @@ Toolset `yandex` включает локальные tools для пользов
 - Яндекс Календарь: календари, список, поиск, создание, перенос, редактирование, повторы, напоминания, удаление событий;
 - Яндекс Документы / 360: работа через Яндекс Диск - список, поиск, создание текстовых документов, чтение, ссылка/QR, переименование, удаление;
 - Яндекс Контакты: статус, список, поиск, карточка, создание, обновление, удаление, импорт/экспорт, дубликаты, неполные карточки, backup на Диск, дни рождения в календарь, письмо/ссылка/встреча по контакту;
+- Комбинированные сценарии: пакет по письму, полный пакет по контакту, ежедневный дайджест, календарные напоминания, аудит Яндекс Диска;
 - Телемост: попытка прямого API и fallback через календарное событие, если API недоступен аккаунту.
 
 Опасные действия ограничены: отправка письма, удаление файлов, публикация ссылок, создание/изменение документов и создание/изменение/удаление событий требуют явного подтверждения в tool-вызове. Токены хранятся локально в `~/.iola/secrets.json`.

package/wiki/Yandex-Cloud-Connector.md

@@ -0,0 +1,127 @@
+# Yandex Cloud Connector
+
+`Yandex Cloud Connector` подключает к `iola-cli` сервисы Yandex Cloud, которые нужны жителю:
+
+- Яндекс Геокодер - адреса, координаты, расстояния, ссылки на карту и deeplink Яндекс Go;
+- YandexGPT - российская AI-модель в меню `/model`.
+
+Это отдельный коннектор. Он не заменяет обычный `Yandex Connector` для Диска, Почты, Календаря и Контактов.
+
+## Как подключить
+
+Самый простой путь:
+
+```bash
+iola master
+```
+
+В мастере выберите:
+
+```text
+4. Yandex Cloud Connector - геокодинг и YandexGPT
+```
+
+CLI откроет консоль Yandex Cloud и попросит сохранить:
+
+- ключ `YANDEX_GEOCODER_API_KEY`;
+- при необходимости YandexGPT API key;
+- при необходимости `YANDEXGPT_FOLDER_ID`.
+
+Геокодер включается по умолчанию. YandexGPT можно включить сразу или позже через `/model`.
+
+Прямые команды:
+
+```bash
+iola yandex cloud setup
+iola yandex cloud status
+iola yandex cloud doctor
+iola yandex cloud enable geocoder yandexgpt
+iola yandex cloud disable yandexgpt
+iola yandex cloud delete
+```
+
+Ключи сохраняются только локально в:
+
+```text
+~/.iola/secrets.json
+```
+
+## YandexGPT в /model
+
+Откройте меню моделей:
+
+```text
+/model
+```
+
+Выберите:
+
+```text
+2. Российские AI (YandexGPT/GigaChat)
+```
+
+Если Yandex Cloud Connector еще не подключен, CLI объяснит, что нужен коннектор, и предложит включить его. Если отказаться, CLI вернется в меню выбора моделей.
+
+## Геокодер
+
+После подключения доступны geo-команды:
+
+```bash
+iola geo key doctor
+iola geo geocode "Йошкар-Ола, улица Петрова, 15"
+iola geo nearby "Йошкар-Ола, улица Петрова, 15" --dataset all --limit 5
+iola geo distance --from "Петрова 15" --to "школа 7"
+iola geo map-link "школа 7"
+iola geo route-context "школа 7"
+```
+
+Геокодер также нужен для Яндекс Go deeplink:
+
+```bash
+iola yandex go link --from "Медведево, Школьная 15" --to "Медведево, Советская 20"
+iola yandex go open --from "Медведево, Школьная 15" --to "Медведево, Советская 20" --tariff econom
+```
+
+Если ключ геокодера не найден, CLI пишет понятную ошибку и предлагает:
+
+```bash
+iola master
+```
+
+или:
+
+```bash
+iola yandex cloud setup
+```
+
+## Яндекс Go
+
+Сейчас `iola-cli` поддерживает только безопасный сценарий:
+
+- уточнить адрес отправления и назначения;
+- получить координаты через геокодер;
+- сформировать deeplink маршрута Яндекс Go;
+- при команде `open` открыть ссылку в браузере или приложении.
+
+CLI не нажимает кнопку заказа, не подтверждает поездку, не списывает деньги и не обещает цену. Цена, повышенный спрос, детское кресло, назначение машины и отмена поездки требуют партнерского `clid/apikey` от Яндекса.
+
+Примеры:
+
+```bash
+iola yandex go link --from "Йошкар-Ола, Ленинский 24" --to "Йошкар-Ола, Кремлевская 26"
+iola ask "сделай ссылку Яндекс Go от Медведево, Школьная 15 до Медведево, Советская 20"
+```
+
+## Ручная инструкция по ключу геокодера
+
+Если нужен только геокодер без YandexGPT, можно использовать отдельную инструкцию:
+
+[Yandex Geocoder API key](Yandex-Geocoder-API-key)
+
+Бесплатный лимит API Геокодера для обычного ключа у Яндекса указан как до 1000 запросов в сутки. Новый ключ может активироваться с задержкой 15-30 минут.
+
+## Важно
+
+Yandex Cloud тарифицирует YandexGPT по правилам Yandex Cloud. Перед активным использованием модели проверьте лимиты и оплату в консоли.
+
+Не публикуйте API-ключи и folder ID в GitHub, README, issue, wiki или чатах поддержки.

package/wiki/Yandex-Connector.md

@@ -42,14 +42,17 @@ iola yandex token delete
 - `docs` - Яндекс Документы / 360 через Диск;
 - `telemost` - Яндекс Телемост через календарное событие.
 
-Отдельные ключи, не обычный OAuth бытового Яндекса:
+Отдельный коннектор, не обычный OAuth бытового Яндекса:
 
-- `cloud` - Yandex Cloud, YandexGPT, SpeechKit, Vision, IAM и folder ID;
-- `maps` - Yandex Geocoder API и карты.
+- `cloud` - Yandex Cloud Connector: ключ геокодера, YandexGPT API key и folder ID;
+- `maps` - Яндекс Геокодер: адреса, координаты, расстояния, ссылки на карту и deeplink маршрута.
+
+Готово без оформления заказа:
+
+- `taxi` - Яндекс Go / Такси: подготовить маршрут, геокодировать адреса, сформировать deeplink и открыть приложение. Заказ, цена и назначение машины ждут партнерский `clid/apikey` от Яндекса;
 
 Backlog после первого контура:
 
-- `taxi` - Яндекс Go / Такси: только подготовить маршрут и открыть приложение, без заказа и оплаты;
 - `market` - Яндекс Маркет: поиск и список покупок, без корзины и оплаты;
 - `delivery` - Яндекс Доставка: подготовка заявки/ссылки, без оформления и оплаты.
 
@@ -107,6 +110,19 @@ iola cloud doctor
 
 Если включен `disk`, токен автоматически подключается и к старому облачному провайдеру `yandex-disk`, поэтому команды `iola cloud ...` продолжают работать.
 
+Yandex Cloud Connector подключается отдельно:
+
+```bash
+iola yandex cloud setup
+iola yandex cloud status
+iola yandex cloud enable geocoder yandexgpt
+iola yandex cloud disable yandexgpt
+```
+
+В `/yandex` для него есть отдельный пункт `Yandex Cloud Connector - геокодинг и YandexGPT`. Геокодер включается по умолчанию, потому что он нужен для geo-skills и deeplink Яндекс Go. YandexGPT можно включить там же или выбрать через `/model`.
+
+Если пользователь выбирает YandexGPT в `/model`, а Cloud Connector еще не подключен, CLI объясняет, что нужен Yandex Cloud Connector, и предлагает открыть настройку.
+
 ## Что значит включить сервис
 
 OAuth-права дают CLI разрешение обращаться к сервису Яндекса. Практическая работа идет через локальные tools:
@@ -182,8 +198,23 @@ QR-код:
 - `yandex_contact_create_calendar_event` - создать встречу с контактом;
 - `yandex_contact_create_telemost_event` - создать событие для Телемоста с контактом;
 - `yandex_contact_from_public_entity` - создать контакт из открытого городского слоя;
+- `yandex_contact_full_pack` - собрать полный пакет по контакту: папка на Диске, заметка, публичная ссылка/QR, событие календаря и опциональное письмо;
+- `yandex_mail_meeting_pack` - собрать пакет по письму: сохранить письмо на Диск, создать ссылку/QR, поставить встречу в календарь и опционально отправить ссылку отправителю;
 - `yandex_telemost_status` - проверить режим Телемоста;
 - `yandex_telemost_create_event` - создать встречу: прямой Telemost API используется только если он доступен аккаунту; иначе создается календарное событие без выдуманной ссылки.
+- `yandex_cloud_status` - проверить Yandex Cloud Connector;
+- `yandex_go_deeplink` - построить deeplink маршрута Яндекс Go по адресам или координатам.
+
+Комбинированные сценарии:
+
+```bash
+iola ask "по последнему письму создай встречу завтра в 14:00, сохрани письмо на диск и пришли отправителю ссылку"
+iola ask "собери полный пакет по контакту Петров: папка на диске, заметка, встреча завтра в 12 и ссылка с QR"
+iola ask "создай папку для школы 2 на яндекс диске и отправь ссылку контакту Иванов"
+iola ask "сделай ссылку Яндекс Go от Медведево, Школьная 15 до Медведево, Советская 20"
+```
+
+CLI использует уже подключенные сервисы: Почту, Диск, Контакты и Календарь. Если не хватает email, найдено несколько контактов или неясна дата встречи, CLI должен уточнить, а не выбирать случайно.
 
 Регулярная проверка контактов:
 
@@ -197,6 +228,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-вызове.
 
 ## Иконка приложения
@@ -219,10 +276,10 @@ docs/assets/iola-oauth-icon.png
 
 Yandex Connector не является универсальным ключом ко всему Яндексу.
 
-Обычные пользовательские сервисы работают через OAuth и scope. Yandex Cloud, YandexGPT и Geocoder требуют отдельные ключи, folder ID или настройки в Yandex Cloud.
+Обычные пользовательские сервисы работают через OAuth и scope. Yandex Cloud, YandexGPT и Geocoder подключаются через отдельный Yandex Cloud Connector.
 
 Для браузерного подключения в сборке CLI уже указан public OAuth `client_id` приложения IOLA. Это не секретный ключ. Пользователь не должен создавать OAuth-приложение вручную.
 
 Яндекс ограничивает количество разных групп сервисов в одном OAuth-приложении. Поэтому один токен не может покрыть Диск, Почту, Календарь и Контакты сразу. CLI использует две встроенные группы: `IOLA CLI A` и `IOLA CLI B`.
 
-CLI не должен автоматически оформлять покупки, вызывать такси, подтверждать доставку или выполнять платежи. Для таких сценариев допустима только подготовка ссылки, маршрута или списка, а финальное действие делает пользователь в приложении Яндекса.
+CLI не должен автоматически оформлять покупки, вызывать такси, подтверждать доставку или выполнять платежи. Для Яндекс Go сейчас допустимы только геокодирование адресов, подготовка deeplink маршрута и открытие приложения. Финальное действие делает пользователь в приложении Яндекса.

package/wiki/Yandex-Geocoder-API-key.md

@@ -1,6 +1,12 @@
 # Yandex Geocoder API key
 
-Эта инструкция нужна для подключения геокодера Яндекса к `iola-cli`.
+Эта инструкция нужна для ручного подключения геокодера Яндекса к `iola-cli`.
+
+Рекомендуемый путь для обычного пользователя - через [Yandex Cloud Connector](Yandex-Cloud-Connector):
+
+```bash
+iola yandex cloud setup
+```
 
 Геокодер нужен жителям для вопросов вида:
 

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

@@ -29,6 +29,8 @@ iola data schools --format csv --output schools.csv
 Геокодер:
 
 ```bash
+iola yandex cloud setup
+iola yandex cloud status
 iola geo key set yandex
 iola geo key status
 iola geo key doctor
@@ -41,6 +43,14 @@ iola geo route-context "школа 7"
 iola geo services "Йошкар-Ола, улица Петрова, 15"
 ```
 
+Яндекс Go deeplink:
+
+```bash
+iola yandex go status
+iola yandex go link --from "Медведево, Школьная 15" --to "Медведево, Советская 20"
+iola yandex go open --from "Медведево, Школьная 15" --to "Медведево, Советская 20" --tariff econom
+```
+
 Облачные диски:
 
 ```bash
@@ -69,6 +79,10 @@ iola yandex status
 iola yandex doctor
 iola yandex enable disk mail calendar
 iola yandex disable mail
+iola yandex cloud setup
+iola yandex cloud enable geocoder yandexgpt
+iola yandex cloud delete
+iola yandex go link --from "Адрес" --to "Адрес"
 iola yandex oauth-url disk --client-id CLIENT_ID
 iola yandex token set
 iola yandex token delete

package/wiki//320/234/320/260/321/201/321/202/320/265/321/200-/320/275/320/260/321/201/321/202/321/200/320/276/320/271/320/272/320/270.md

@@ -30,11 +30,15 @@ iola master
 
 После настройки локальную модель можно менять в интерактивном агенте через `/model`. Помимо штатной IOLA-модели можно выбрать установленную или рекомендуемую Ollama-модель, либо вручную ввести имя любой модели из библиотеки Ollama.
 
-### 4. YandexGPT API
+### 4. Yandex Cloud Connector
 
-Настраивает профиль YandexGPT и сохраняет API key плюс folder ID локально у пользователя.
+Настраивает Yandex Cloud Connector: геокодер и, при необходимости, YandexGPT.
 
-Российский провайдер вызывается напрямую, без gateway/proxy.
+Геокодер включается по умолчанию. Он нужен для geo-skills и deeplink Яндекс Go. YandexGPT можно включить сразу или выбрать позже через `/model`.
+
+Ключи сохраняются локально у пользователя. Российский AI-провайдер вызывается напрямую, без gateway/proxy.
+
+Инструкция: [Yandex Cloud Connector](Yandex-Cloud-Connector).
 
 ### 5. GigaChat API
 
@@ -86,15 +90,7 @@ iola index folder ./docs
 
 Если runtime уже установлен, пункт показывается как `готово`.
 
-### 14. Yandex Geocoder API
-
-Сохраняет ключ Yandex Geocoder API локально у пользователя и проверяет его тестовым запросом.
-
-Нужен для будущих geo-skills: поиск объектов рядом с адресом, ссылки на карту, определение расстояний и уточнение населенного пункта.
-
-Инструкция по получению ключа: [Yandex Geocoder API key](Yandex-Geocoder-API-key).
-
-### 15. Облачный диск
+### 14. Облачный диск
 
 Подключает личный облачный диск пользователя:
 
@@ -105,7 +101,7 @@ iola index folder ./docs
 
 Инструкция: [Облачные диски](Облачные-диски).
 
-### 16. Yandex Connector
+### 15. Yandex Connector
 
 Настраивает единый коннектор пользовательских сервисов Яндекса.
 
@@ -116,7 +112,7 @@ iola index folder ./docs
 
 Мастер не спрашивает список сервисов. Он подключает коннектор с максимальным набором OAuth-прав, а активные функции CLI выбираются позже командой `/yandex` в интерактивном CLI или `iola yandex menu` в терминале.
 
-В коннектор также заложены категории для проверки: Почта, Календарь, Контакты, Wiki, Tracker, Forms, Документы/360. Такси, Маркет и Доставка записаны в backlog только как подготовка ссылки, маршрута или списка без заказа и оплаты.
+В коннектор также заложены категории для проверки: Почта, Календарь, Контакты, Документы/360 и Телемост. Яндекс Go deeplink работает через Yandex Cloud Connector и геокодер; заказ такси, Маркет и Доставка остаются без оформления заказа и оплаты.
 
 Инструкция: [Yandex Connector](Yandex-Connector).
 

package/wiki//320/240/320/265/321/210/320/265/320/275/320/270/320/265-/320/277/321/200/320/276/320/261/320/273/320/265/320/274.md

@@ -28,7 +28,7 @@ iola ai doctor
 
 ```bash
 iola ai key status
-iola ai key set yandexgpt
+iola yandex cloud setup
 iola ai key set gigachat
 iola ai key set openai
 iola ai key set openrouter
@@ -41,7 +41,7 @@ iola ai key set openrouter
 - OpenAI Platform: `https://platform.openai.com/api-keys`
 - OpenRouter: `https://openrouter.ai/settings/keys`
 
-Для YandexGPT нужен не только API key, но и folder ID каталога Yandex Cloud. Для GigaChat нужен authorization key; CLI сам получает OAuth-токен перед запросом.
+Для YandexGPT нужен не только API key, но и folder ID каталога Yandex Cloud. Рекомендуемый путь - `iola yandex cloud setup`, там же подключается ключ геокодера для geo-skills и Яндекс Go deeplink. Для GigaChat нужен authorization key; CLI сам получает OAuth-токен перед запросом.
 
 Важно: оплата российскими банковскими картами для OpenAI Platform и OpenRouter может быть невозможна. Если API-запросы не проходят после сохранения ключа, проверьте не только ключ, но и billing/баланс в личном кабинете сервиса.
 

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

@@ -322,6 +322,7 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 - создать папку контакта на Яндекс Диске и сохранить туда `contact.vcf` и `README.txt`;
 - создать встречу с контактом в Яндекс Календаре;
 - создать календарное событие для Телемоста с контактом;
+- создать полный пакет контакта: папка на Диске, Markdown-документ, публичная ссылка, QR-код и встреча в календаре;
 - создать контакт из открытого городского слоя, если у школы или детского сада есть публичный email или телефон.
 
 Примеры:
@@ -329,9 +330,26 @@ 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
 
 Подготовить встречу через Телемост:
@@ -342,20 +360,53 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 
 CLI не должен сам нажимать финальные кнопки в веб-интерфейсе Яндекса без явного действия пользователя и не должен выдумывать ссылку Телемоста.
 
-## Yandex Connector backlog
+### 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 Go deeplink
+
+Эти сценарии не оформляют заказ, не списывают деньги и не нажимают финальную кнопку вместо пользователя.
 
 ### taxi-prepare-ride
 
 Подготовить поездку в Яндекс Go:
 
 - уточнить точку отправления и назначения;
-- геокодировать адреса;
+- геокодировать адреса через Yandex Cloud Connector;
 - сформировать ссылку/deep link в Яндекс Go;
 - открыть приложение или страницу;
 - пользователь сам проверяет цену и нажимает заказ.
 
+Команды:
+
+```bash
+iola yandex go link --from "Медведево, Школьная 15" --to "Медведево, Советская 20"
+iola yandex go open --from "Медведево, Школьная 15" --to "Медведево, Советская 20" --tariff econom
+```
+
+Если ключ геокодера не подключен, CLI должен объяснить, что нужно открыть `/master` и выбрать `Yandex Cloud Connector (геокодинг и YandexGPT)`, либо запустить `iola yandex cloud setup`.
+
+Цена, повышенный спрос, детское кресло, назначение машины и отмена поездки через API ждут партнерский `clid/apikey` от Яндекса.
+
+## Yandex Connector backlog
+
+Эти сценарии зафиксированы для следующего этапа. Они не должны оформлять заказ, списывать деньги или нажимать финальную кнопку вместо пользователя.
+
 ### market-prepare-cart
 
 Подготовить список покупок для Яндекс Маркета: