Telegram-агент, который
ничего не забывает за тебя

Собери мне персонального агента, который мониторит мои чаты в Telegram и присылает
сводку важного: договорённости о звонках/встречах (с автопостановкой в Google
Calendar), обязательства ("я должен/должна X", с пометкой срочности), прочие важные
рабочие моменты.

АРХИТЕКТУРА (обязательно так, не предлагай альтернатив без явного запроса):
- Отдельный локальный Python-проект в НОВОЙ папке в моей домашней директории —
  НЕ встроенный в текущую сессию чата, потому что доступ к личному Telegram-
  аккаунту и ежедневная автономная работа требуют отдельного локального
  процесса, независимого от того, открыт ли чат со мной.
- Если ты собираешь это на macOS: НЕ клади проект на Desktop, в Documents или
  в Downloads — macOS блокирует фоновым процессам доступ к этим трём папкам без
  отдельного разрешения, и автозапуск будет молча падать с PermissionError.
  Используй домашнюю папку напрямую (например ~/telegram-digest).
- Telegram: доступ через личный аккаунт (MTProto, библиотека Telethon), НЕ через
  Bot API — боты не видят личные переписки, а мне нужны в том числе они.
- Анализ переписок: Anthropic API (модель claude-sonnet-5), forced tool-use для
  структурированного JSON-ответа (не текстовый JSON — ловит меньше ошибок парсинга).
- Переписка в анализе группируется в два уровня: клиент/проект → конкретный чат
  внутри него (см. пункт 8 брифа) — это сильно снижает путаницу между чатами с
  похожими или пересекающимися темами.
- Календарь: Google Calendar API, OAuth (Desktop app), события без приглашения
  участников — только в мой личный календарь. При создании события ВСЕГДА отправляй
  "наивное" время (без +HH:MM смещения в строке) плюс отдельное поле timeZone —
  если положить туда одновременно и смещение, и timeZone, Google Calendar API
  начинает непредсказуемо путать часы (проверено на практике).
- Голосовые сообщения: расшифровывать через faster-whisper (модель "small",
  локально, бесплатно, БЕЗ системного ffmpeg — аудио декодируется через PyAV,
  которая ставится через pip и тащит свои библиотеки).
- Доставка сводки: НЕ в Saved Messages, а в отдельный приватный Telegram-канал,
  который скрипт сам создаёт через Telethon (CreateChannelRequest, я в нём
  единственный участник).
- Планировщик: используй родной для моей операционной системы механизм
  автозапуска — launchd на macOS, Task Scheduler на Windows, cron/systemd timer
  на Linux. Если нужно два запуска в день (см. пункт 3 брифа) — настрой два
  отдельных задания с разными аргументами командной строки, конкретный способ
  зависит от ОС.
- ВАЖНО: планировщик ориентируется на системные часы компьютера, а не на
  TIMEZONE-переменную из .env — это два независимых понятия. Сверь их и явно
  спроси меня, если они расходятся.
- Предупреди меня заранее, что деньги на Anthropic API могут закончиться молча
  (скрипт просто перестанет работать без явного уведомления) — и сразу покажи,
  как включить Auto-reload в Anthropic Console, чтобы это не повторялось.

БРИФ (мои ответы ниже; там, где пусто — спроси меня, не додумывай сам):

1. Какие чаты мониторить:
   [ ] все личные чаты и группы, кроме каналов-подписок (по умолчанию)
   [ ] только группы
   [ ] другое: _______

2. Куда присылать сводку:
   [ ] отдельный приватный Telegram-канал (по умолчанию)
   [ ] Saved Messages
   [ ] другое: _______

3. Расписание:
   [ ] один запуск в день (по умолчанию), время: _______
   [ ] два запуска: дневной (тихий, только календарь, без сводки) в _____ и
       вечерний (со сводкой) в _____ — только если специально нужно
   Часовой пояс, в котором это время должно срабатывать: _______

4. Что делать с найденными созвонами/встречами:
   [ ] ставить в Google Calendar автоматически, без приглашения участников
       (по умолчанию)
   [ ] только упоминать в тексте сводки, в календарь не ставить
   [ ] другое: _______

5. Нужно ли распознавание голосовых сообщений:
   [ ] да (по умолчанию)
   [ ] нет, только текст

6. Формат сводки — заголовок и разделы (можно оставить пример или дать свой):
   🔔 СВОДКА ВАЖНОГО ЗА ДЕНЬ
   🔥 Горит по срокам (обязательства со сроком сегодня/завтра или явной срочностью)
   📅 Созвоны/встречи
   🤝 Договорённости/задачи
   📌 Другое важное
   ✅ Добавлено в календарь сегодня (если решишь ставить события в календарь)

7. Часовой пояс для резолва дат ("завтра"/"в четверг"/"в 10:00"): _______

8. Есть ли чаты, которые относятся к одному клиенту/проекту, но называются
   по-разному? Перечисли ТОЧНЫЕ названия чатов как они есть в Telegram (не
   пересказ, а дословно — регистр и пробелы важны):
   _______

9. Нужна ли возможность искать по уже накопленным перепискам (например,
   "когда и в каком чате Х говорил про Y за последний месяц")?
   [ ] да, добавь отдельную команду поиска (по умолчанию)
   [ ] нет, не нужно

ПОРЯДОК РАБОТЫ:
1. Сначала задай мне уточняющие вопросы по брифу выше, НЕ приступай к коду сразу.
2. Собери проект и синтаксически проверь все модули до того, как просить меня
   заводить настоящие ключи.
3. Проведи меня по подключению внешних сервисов ПОШАГОВО и ПРОСТЫМ ЯЗЫКОМ, без
   технического жаргона, буквально «нажми сюда». Если у меня не открывается
   терминал — открой его сам. Учитывай мою операционную систему.
4. Логины и пароли (код Telegram, пароль двухфакторки, вход в Google) ввожу
   СТРОГО лично я — не проси присылать их тебе в чат и не вводи их за меня.
5. После настройки прогони пайплайн на реальных сегодняшних данных, покажи мне
   результат ДО отправки в календарь/канал.
6. Настрой автозапуск и покажи, как проверить/остановить.
7. Если в брифе отмечен поиск (пункт 9): добавь search.py — он берёт все
   сохранённые файлы data/raw/*.json за нужный период (по умолчанию месяц,
   можно указать другой), находит подходящие сообщения по ключевым словам и
   прогоняет их через Claude, чтобы получить внятный ответ: где, когда, кто
   именно это сказал, с цитатой. Покажи, как им пользоваться — просто попросить
   в чате "найди, когда в переписках говорили про Х".

ВАЖНО ПРО КОНФИДЕНЦИАЛЬНОСТЬ:
- Все ключи/сессии/токены — только локально, в .gitignore.
- Тексты переписок уходят ТОЛЬКО в Anthropic API для анализа, больше никуда —
  объясни мне это словами.
- Ты не входишь в мои аккаунты за меня — код и пароли ввожу я.