Files
buryan-infra/ops/work/SECRETARY.md

4.8 KiB

Рабочий секретарь — v2 (напоминания + Nextcloud)

Обновлено 28.10.2026.

Что нового против v1

  1. Напоминания. «напомни через 2 часа про #3», «напомни завтра в 10», «напомни в пятницу в 9»; список — команда напоминания. Напоминание приходит в комнату и само снимается, если задачу закрыли.
  2. Синхронизация в Nextcloud. Задачи дублируются как VTODO в календарь-список «Работа» аккаунта roman — отдельный аккаунт не заводили, как и просил владелец: у него будут «Работа», «Дом» и прочие списки в одном месте. Команда синк отправляет все открытые задачи сразу.
  3. Промпт агента ужесточён: он трогает только те задачи, о которых идёт речь, и не подмешивает посторонние (раньше обновлял #1 в каждом действии).

Как устроена синхронизация

  • CalDAV, Basic-auth по app-паролю Nextcloud (/root/.nextcloud-app-pass).
  • URL: …/remote.php/dav/calendars/roman/work/, UID задачи — work-<id>@buryans.ru.
  • Поля VTODO: SUMMARY (текст), CATEGORIES (тип), DUE (срок), STATUS, X-BURYANS-ITEM (номер задачи в базе секретаря).
  • Создание/правка/закрытие/удаление в Matrix → те же операции в Nextcloud.

Проверено 28.10.2026

«синк» -> «Отправлено в Nextcloud (список «Работа»): 2 из 2»
REPORT по календарю: 2 задачи — «Выдать КП по Vinteo для Кабаков Максим»,
«Разобраться с проектом Ricoh…»
напоминание через 1 минуту -> пришло в комнату

Ловушки

  • Переменные окружения. bot.env читался в словарь, но не в os.environ, поэтому caldav видел пустой пароль и молча возвращал 0. Теперь ключи пробрасываются в окружение, а конфиг CalDAV читается при вызове, не при импорте.
  • import caldav — модуль должен лежать в /opt/work-hub рядом с ботом, иначе служба уходит в цикл перезапуска с ModuleNotFoundError.

Файлы

ops/work/stack/: bot.py, agent.py, store.py, matrix.py, parse.py, caldav.py. Служба work-secretary.service, сводки work-digest.timer (08:00 и 18:30), хранилище /opt/work-hub (700).

v3: встречи в календаре (28.10.2026)

Встречи разбираются детерминированно, без модели: слово-триггер («встреча», «созвон», «приезд», «демо в») + дата/время из фразы («в пятницу в 14:00», «завтра в 10»). Создаётся VEVENT в календаре «Работа» того же аккаунта Nextcloud, длительность по умолчанию 1 час.

Почему без модели: на запрос «встреча в пятницу в 14:00…» агент дважды отвечал «создал», не создав ничего, а затем стал переспрашивать — тянул лишнее из истории переписки. Для структурированного запроса правило надёжнее.

Проверено: событие в календаре с DTSTART:20261030T140000, ответ бота: «Встреча #5: 30.10 в 14:00 — …».

Задачи (VTODO) остаются на агенте, встречи (VEVENT) — на правилах.

Ловушки

  • Агент пишет «создал», не выполнив действие: его ответ надо логировать. Теперь сырой JSON пишется в /var/log/work-agent.jsonl — по нему видно, что именно вернула модель.
  • Дата из модели может прийти в разных форматах; для встреч добавлен разбор по нескольким шаблонам, а при неудаче задача всё равно создаётся (без календаря) и бот честно об этом сообщает.