# WALKTHROUGH — Email Assistant (капитанский журнал)

Воспроизводимость: хронология, команды, решения, ошибки и как чинили.

## 2026-09-11

### Фаза 1.7: динамическое обнаружение подпапок INBOX

**Проблема:** `mail_archive.py` хардкодил 18 подпапок INBOX, на сервере их 136+.

**Решение в `mail_archive.py`:**
1. `get_inbox_subfolders()` — парсит `himalaya folder list` (таблица ASCII),
   фильтрует `INBOX/`, поддерживает глубину 3, fallback на хардкод при ошибке.
2. `--all` = `FOLDERS + get_inbox_subfolders()` → 140 папок.
3. `run_cmd()` — добавлен `try/except FileNotFoundError` (himalaya не в PATH).
4. Таймаут envelope list поднят 60 → 180с: INBOX (14k писем) перечислялась >60с.

**Проверено:**
- `get_inbox_subfolders()` → 136 папок, 120 глубоких.
- `--folder "INBOX/!Реестр платежей/Акты" --limit 10 --drain` — работает.
- `--folder "INBOX/!Завки/Либра" --limit 5 --drain` — 4 письма, OK.
- Smoke `--all` с заглушкой archive_folder — 140 папок в списке.
- Fallback (HIMALAYA_CMD=несуществующий) — работает.

**Зависание `--all`:** `envelope list` на большой INBOX висел >60с (таймаут).
Поднятие до 180с + `--drain` (предохранитель 10k проходов) решило. Крон-обёртка
`mail-archive.sh` переведена на `--all --drain` + `HOME=/home/estorozhenko`
(himalaya не находил конфиг из-за смены HOME).

**Git:** c7430d1 «feat: динамическое обнаружение подпапок INBOX (Фаза 1.7)».

### Анализ Nylas CLI → отклонено

**Задача:** пользователь спросил, упростит ли Nylas получение/отправку писем.

**Вывод:** Nylas — **облачный SaaS** (api.us.nylas.com), не локальный CLI.
Письма идут через серверы Nylas; платная подписка; IMAP-гранты гибнут при
ротации пароля; Contacts API для generic IMAP платный. Для корпоративного
IMAP + локального архива — **не подходит**.

**Artifacts:** `NYLAS_ANALYSIS.md` + ссылка в README. Git: d4bf3ed.

### Задача 4: Анализ ФС vs Maildir → закрыт

**Задача:** оценить, удобен ли формат `email.md` (ФС) vs Maildir/MBOX/notmuch,
учитывая мотивацию — локальная LLM в скриптах без облака.

**Реальные данные (замер):** 4884 email.md, 76 МБ; INBOX 2674 (вкл. 1224 в 2026/),
Archive 876, Отправленные 790, Sent 544; контактов 81 (а не 5!).

**Вывод (STORAGE_ANALYSIS.md):** **остаться на email.md** — он идеален для
LLM-скриптов (`cat email.md | ollama run qwen3:8b`), человекочитаем, атомарен
(папка UID на письмо). Maildir даёт стандартность, но raw-MIME (нужен парсер),
нечитаемые имена, НЕТ тэгов. Эволюция: `tags: []` в frontmatter + опц. экспорт
в Maildir + FTS5 остаётся.

**OpenSpec:** change `email-storage-analysis` (3 требования) → validate → archive
(delta → openspec/specs/email-storage-format/spec.md). Git e31b5f2.

### Портфель: веб-UI + календарь/задачи (ПЛАН)

`PLAN_WEBUI.md` — 7 задач, порядок 4→2→3→1→6→7. Решения пользователя:
- Трекер задач и календаря НЕТ → добавлять как отдельные сервисы.
- **Все сервисы — в отдельных Docker-контейнерах.**
- Стек: **Radicale (CalDAV) + Vikunja (трекер)**.

### Задача 2: Radicale (docker) — развёрнут частично

**Сделано:**
1. `/opt/hermes/radicale/docker-compose.yml` (образ `kozea/radicale`, порт 5232).
2. Конфиг `/opt/hermes/radicale/config/config` (htpasswd, owner_only, /data/collections).
3. Пользователь `estorozhenko` — `htpasswd -c -b -m data/users estorozhenko <pass>`
   (пароль в `/opt/hermes/radicale/.env`, `RADICALE_PASS`).
4. `docker compose up -d` → контейнер `radicale` работает.

**Проверено:** `curl -X PROPFIND http://127.0.0.1:5232/ -u estorozhenko:PASS` → **207**;
без пароля → **401** ✅. Radicale 3.8.1.dev0, слушает 0.0.0.0:5232.

**Ошибка/урок:** `command: ["radicale", "-C", ...]` падал `unrecognized arguments:
radicale` — entrypoint образа УЖЕ вызывает `radicale`, передавать только флаги:
`command: ["-C", "/config/config"]`.

**Заблокировано:** создание коллекций. `MKCOL /Личный/` → **403**. Radicale 3.x
создаёт коллекции иначе (PUT ресурса с Content-Type: text/calendar в новую
коллекцию). Попытка проверки через PUT тестового VEVENT была **заблокирована
таймаутом команды** (execution guard) — жду решение пользователя/возобновление.

**Осталось (Задача 2):** коллекции (Личный/Рабочий/Задачи), Vikunja (:3456,
postgres), Caddy (cal.nixg.ru, tasks.nixg.ru), Android.

### Известные открытые хвосты (репозиторий)
- `PLAN_WEBUI.md` — untracked (не закоммичен).
- Cron mail-index-incremental и digest-weekly — не настроены.
- Push mirror gitea → gitverse — не настроен (нужен токен [REDACTED]).