# Todoist — архив задач

> Как подключить Todoist к MMW, сохранить доступные задачи и историю, найти запись и экспортировать архив.

MMW может **сохранять доступные данные Todoist в независимый архив**, чтобы они оставались у вас даже после отключения интеграции. Это интеграция для хранения и поиска, а не ещё один менеджер задач.

## Что уже работает

- Однократное подключение через официальный Todoist OAuth с правом **только чтения** (`data:read`).
- Первоначальное получение доступных проектов, задач, комментариев и других структур Todoist.
- Автоматическая сверка новых изменений примерно **каждые 10 минут** и ручной запуск синхронизации.
- Отдельная загрузка доступного журнала активности и выполненных задач. Проверка старых выполненных задач идёт постепенно.
- Шифрованное хранение оригинальных ответов Todoist и изменённых версий объектов в вашем личном пространстве.
- Просмотр архива, поиск по тексту, фильтрация по типам, переход по страницам и экспорт JSON.
- Отключение Todoist без автоматического удаления уже сохранённого архива.

Todoist остаётся **отдельным личным архивом**: его записи не подмешиваются автоматически в общий поиск MMW. Однако теперь AI-клиенты могут найти их **по явному запросу** через MMW `search`, начиная текст с `todoist:`, например `todoist: ВОЛС`. Совместимые MCP-клиенты могут также вызвать `search_todoist`. Результаты содержат идентификаторы источников и хеши, но не копируются в общую память автоматически.

## Подключение

1. Войдите в [личный кабинет MMW](https://app.mmwhub.ru/?tab=integrations), откройте раздел **«Интеграции»** и найдите карточку **Todoist**.

2. Нажмите **«Подключить Todoist»**. MMW перенаправит вас на официальную страницу авторизации Todoist.

3. Войдите в Todoist, если потребуется, и подтвердите доступ **на чтение**. Не передавайте в MMW пароль от Todoist и не отправляйте API-токены в поддержку.

4. После возвращения в кабинет на карточке появится статус **«Подключён»**. Первоначальная загрузка и последующие сверки сохраняют доступные данные в архив. Если счётчик пока не изменился, нажмите **«Синхронизировать»**.

Всё происходит в вашем **личном пространстве** MMW. Данные аккаунта не добавляются в организационное пространство автоматически.

## Как найти сохранённую задачу

1. В кабинете откройте **«Интеграции» → «Todoist» → «Просмотреть архив»**.
2. Введите в поиск часть названия задачи, проекта или другой текст из исходной записи. Можно искать на русском.
3. При необходимости выберите тип: задачи, проекты, комментарии, события или выполненные задачи.
4. Откройте **«Показать исходную запись»**, чтобы увидеть данные, полученные от Todoist. Используйте кнопки **«Назад»** и **«Дальше»** для других страниц.

Поиск обрабатывает архив в рамках вашего аккаунта. Сейчас он просматривает не более первых **10 000 сохранённых версий** за один поисковый запрос. Это не семантический поиск AI-агента: для точности используйте слова из задачи.

## Поиск Todoist из ChatGPT, Claude и других AI-клиентов

В любом подключённом клиенте MMW вызовите инструмент `search` и передайте запрос с префиксом `todoist:`, например `todoist: ВОЛС`. Если клиент поддерживает обновлённый набор MCP-инструментов, можно напрямую вызвать `search_todoist(query="ВОЛС")`.

Поиск выполняется по **вашему личному архиву Todoist**, не предоставляет доступ к чужим данным и не записывает результаты в общую память MMW. Обычный поиск без префикса `todoist:` продолжает работать с обычными записями MMW.

## Запрос к памяти MMW прямо из Todoist — готовится

MMW разрабатывает собственное **Todoist UI Extension** для поиска по общей памяти непосредственно из задачи или проекта. Предусмотрен сценарий: открыть меню задачи → **Search MMW** → ввести запрос → просмотреть до пяти найденных записей, не выходя из Todoist. Расширение будет работать только от имени владельца подключённого аккаунта MMW.

Защищённый серверный обработчик готов, но расширение ещё **не зарегистрировано и не установлено** через Todoist App Management Console. До завершения этого этапа кнопки Search MMW в Todoist нет. Доступный сейчас поиск — через личный кабинет MMW или подключённых AI-клиентов.

По официальной документации Todoist, такие расширения доступны на **вебе и компьютере**, но пока не на мобильных устройствах. Поиск не изменяет задачи и не требует выдавать MMW право записи в Todoist.

## Состояние архива и история версий

В личном кабинете откройте **«Интеграции» → «Todoist»** и нажмите **«Проверить архив»**. MMW покажет количество сохранённых версий и отдельных объектов, состояние последней синхронизации, результат проверки целостности, а также доступные показатели исторической загрузки.

**Проверка целостности** расшифровывает и сверяет хеши максимум **250 последних сохранённых версий**. Если записей больше, интерфейс укажет, что проверена выборка, а не весь архив. Успешная проверка подтверждает читаемость и совпадение хешей проверенных записей, но не гарантирует наличие данных, которые Todoist не передал.

Для просмотра изменений конкретной задачи или проекта откройте **«Просмотреть архив»** и нажмите **«История версий»** у нужной записи. Вы увидите сохранённые версии по времени и список полей, изменившихся между соседними снимками. Это история **зафиксированных MMW состояний**, а не полный журнал всех действий пользователя в Todoist.

## Экспорт архива

В карточке Todoist нажмите **«Экспорт JSON»**. Браузер выгрузит файл `mmw-todoist-archive.json` с сохранёнными записями, их источниками и временем получения. Экспорт предназначен для резервной копии и дальнейшей обработки пользователем.

Экспорт начинается с фиксации времени: все страницы относятся к одному верхнему временному пределу. Файл JSON содержит поля `schema_version: 2` и `as_of`. Во время выгрузки MMW сверяет число записей и обнаруживает повторения между страницами. Это снижает риск неполной выгрузки при продолжающейся синхронизации, но не заменяет резервное копирование всей системы.

**Проверить скачанный файл без MMW:** используйте [скрипт проверки JSON](https://github.com/msingatullin/mmw/blob/main/tools/verify_todoist_export.py) из репозитория проекта с командой `python3 verify_todoist_export.py mmw-todoist-archive.json`. Скрипт проверяет хеши каждой сохранённой записи, количество записей, повторы и временные границы. Он проверяет внутреннюю целостность файла, **а не подлинность происхождения или полноту истории Todoist**.

Экспорт формируется из нескольких страниц архива и сейчас ограничен **50 000 записями за одну операцию**. Если архив крупнее или загрузка прервана, появится ошибка — существующие данные в MMW не меняются.

Храните скачанный JSON в защищённом месте. В отличие от зашифрованного архива на сервере MMW, файл экспорта содержит исходные данные, которые пользователь может прочитать.

## Что сохраняется и чего может не быть

| Данные | Особенности |
|---|---|
| Проекты, задачи и комментарии | Сохраняются те записи и изменения, которые реально передаёт API Todoist. |
| Выполненные задачи | Загружаются отдельно и историческими интервалами; старые периоды обрабатываются постепенно. |
| Журнал активности | Доступность и глубина истории зависят от тарифа Todoist. В некоторых аккаунтах журнал доступен только за **7 дней**. |
| Удалённые ранее данные | Если Todoist уже не отдаёт их через API и они ранее не были сохранены в MMW, восстановить их из воздуха невозможно. |
| История изменения содержимого | MMW хранит версии, полученные во время синхронизаций. Это **не гарантия фиксации каждого изменения** между двумя опросами. |

Синхронизация сейчас использует периодические запросы к Todoist API; обработка событий Webhooks ещё не включена. Поэтому кратковременные изменения между сверками могут не попасть в архив. Готовность очередного исторического периода не означает, что за него обязательно были найдены задачи.

## Отключение и удаление

- **Отключить интеграцию:** карточка Todoist → **«Отключить»**. Следующие синхронизации прекращаются, зашифрованный архив остаётся в MMW.
- **Удалить архив:** нажмите **«Удалить архив MMW»** на карточке Todoist. MMW покажет число архивных записей и предупреждение, выдаст одноразовое подтверждение на 5 минут; для удаления необходимо самостоятельно ввести `DELETE TODOIST ARCHIVE` и подтвердить действие. Удаляются архивные версии, исходные ответы API, история синхронизации и ключ подключения **из активной базы MMW**. Сохранённые ранее резервные копии подчиняются отдельным срокам хранения и не стираются мгновенно. Задачи в самом Todoist не затрагиваются. Если нужна информация об удалении резервных копий, обратитесь в [поддержку](mailto:support@mmwhub.tech). Команда `forget` относится к обычной памяти MMW, не к этому архиву.
- **Снова подключить:** можно подключить **тот же аккаунт Todoist**. Чтобы данные разных аккаунтов не перемешались, MMW не разрешает связать с существующим архивом другой аккаунт Todoist.

Подробнее о хранении и правах: [Данные и удаление](/account/data-and-deletion/).

## Безопасность и ограничения

- MMW запрашивает только `data:read`: интеграция не создаёт, не меняет и не удаляет задачи в Todoist.
- Токен доступа и архивные данные хранятся на сервере в зашифрованном виде.
- Доступ к архиву требует входа в MMW и ограничен вашим личным пространством.
- Если Todoist недоступен или вводит ограничения API, следующая синхронизация может задержаться. Ранее сохранённые записи остаются в архиве.

**Техническая основа:** [Todoist API v1](https://developer.todoist.com/api/v1/). Статус функций указан по состоянию на 15 ноября 2026 года.

## Что дальше
