email-assistant/openspec/changes/archive/2026-09-14-email-classification-handlers/tasks.md

Tasks: Классификация писем и подключение обработчиков

1. Починить скачивание вложений

• 1.1 Исправить get_attachments() в scripts/mail_archive.py: заменить --dir на --downloads-dir, передавать <msg_dir>/attachments/
• 1.2 Не создавать папку attachments/ для писем без вложений (создавать только если has_attachment: true или команда что-то вернула)
• 1.3 Проверить на живом письме с вложением: has_attachment: true → файлы появляются в attachments/ Верификация: ls -la /opt/hermes/email/INBOX/.../<uid>/attachments/
• 1.4 Проверить идемпотентность: повторный запуск не качает повторно

2. Классификатор писем (email_classifier.py)

• 2.1 Создать scripts/email_classifier.py: - читает неклассифицированные email.md (нет classification) - чистит текст (переиспользовать clean_body из contacts_extractor) - вызывает Qwen3:8b (Ollama localhost:11434) с промптом классификации - получает JSON: tags + reason + (для meeting) datetime
• 2.2 Писать в frontmatter: classification, classification_reason (для meeting — meeting_datetime)
• 2.3 Обработка ошибок: невалидный JSON/нет ответа → unclassified, продолжить
• 2.4 --limit N для дозирования (как contacts_extractor)
• 2.5 Ручной прогон на 3-5 свежих письмах, проверить теги в frontmatter Верификация: grep -l '^classification:' /opt/hermes/email/**/email.md | head

3. Обработчики (email_handlers.py)

• 3.1 Создать scripts/email_handlers.py: сканирует письма с тегами и без handled_*
• 3.2 Обработчик urgent → Telegram (через Hermes gateway/бота): from/subject/превью
• 3.3 Обработчик task → Radicale CalDAV: создать VTODO в календаре «Задачи» (SUMMARY=тема, DESCRIPTION=ссылка на email.md, DTSTART/DUE при наличии даты) вместо Vikunja API (см. чейндж remove-vikunja-use-radicale-tasks)
• 3.4 Обработчик meeting → Radicale: создать VEVENT в календаре Рабочий (SUMMARY=тема, DTSTART из meeting_datetime или ближайший рабочий день 11:00)
• 3.5 Помечать письмо handled_urgent / handled_task / handled_meeting
• 3.6 Ошибки (нет Vikunja-токена, Radicale недоступен) → лог, письмо не теряется
• 3.7 Проверить: urgent-письмо уходит в Telegram; meeting-письмо создаёт VEVENT (механика sendMessage готова и токен подхватывается; живого urgent-письма пока нет — сработает при появлении)

4. Подготовка зависимостей

• 4.1 Секреты в .env/config: Telegram chat_id/token (для обработчика urgent), Radicale Basic-auth (уже есть в проекте)
• 4.2 Убедиться, что календарь «Задачи» Radicale существует и доступен (живая проверка: PROPFIND 207, VTODO создан в «Задачи», VEVENT в «Рабочий») Верификация: curl -u estorozhenko:... -X PROPFIND -H 'Depth: 0' https://cal.nixg.ru/estorozhenko/<urlencoded Задачи>/

5. Cron

• 5.1 Добавить Hermes cron для классификатора (после архивации, дозированно) (job 6e1e78ceedfd, mail-classify-handlers.sh, каждые 5 мин, лимит 10)
• 5.2 Добавить Hermes cron для обработчиков (тот же job: классификатор → обработчики в одной обёртке)
• 5.3 Проверить, что цепочка работает end-to-end на новом письме (живой прогон: 5 новых писем → meeting → 5 VEVENT созданы (201))

6. Документация

• 6.1 Обновить STATUS.md: новые скрипты, cron, фронтмэттер поля
• 6.2 Зафиксировать доступы (Vikunja token, Telegram) в ресурсах проекта