ADR 0023: Канал «готовность окружения» (glance) — отдельно от IDE Health¶
Статус: Accepted (границы решения и отбор сигналов; конкретный UI и типы в коде — по мере реализации)
Дата: 2026-04-11
Связанные ADR¶
| ADR | Роль |
|---|---|
| 0021 | PFD / MFD — модель внимания кокпита Cascade IDE |
| 0022 | лексикон IDE Health — другой канал |
| 0089 | переименование канала наблюдаемости |
Резюме¶
- Markdown + Mermaid/PlantUML — first-class через LSP и workflow.
- Kroki, export expanded, authoring — ортогонально preview (0069).
Вне ADR¶
| Документ | Роль |
|---|---|
environment-readiness-glance-v1.md |
чертёж readiness glance |
Контекст¶
- Пользователю нужен быстрый осмотр: подключён ли LSP, доступны ли нужные инструменты, выставлены ли релевантные переменные — без открытия настроек, если цель не редактирование, а напоминание (периферийное внимание, ADR 0021).
- Канал IDE Health закреплён за задачей в workspace (сборка, тесты, отладка, git). Смешивать с ним «всё ли ок с инструментами и средой» — порочит терминологию и UX.
- Полный дамп переменных окружения процесса неприемлем (шум, риск утечки, не отвечает на вопрос «нужное ли для IDE»).
Решение¶
- Вводится отдельный продуктовый канал готовность окружения (рабочее имя в UI: по согласованию; в доках — environment readiness / glance). Он не использует префиксы
IdeHealth*в контрактах этого канала и не конфигурируется ключамиide_health_*в TOML режимов — эти ключи относятся к IDE Health; размещение readiness задаётся отдельно (пресет, ADR 0021). - Снимок канала строится только из сигналов, которые IDE уже использует или явно должна проверить для своих сценариев (LSP, внешние MCP, выбранный транспорт чата, необходимость
dotnetи т.д.). - Переменные окружения на этом канале: только имена, которые Cascade IDE реально читает для работы фич, либо согласованный минимальный чеклист для документированных сценариев. Не выводить весь
environ. - Исполняемые файлы: проверка необходимых для IDE инструментов — по явному пути из настроек или через разрешение по PATH (Windows) и PATH / принятым аналогам на Linux; не «все программы на диске».
- Экран настроек остаётся местом редактирования; канал readiness — осмотр и короткие подсказки + ссылка «Открыть настройки». Секреты и ключи API на glance не показывать в открытом виде (маскировать или не отображать).
- Слой представления (полноэкранная страница во вторичном контуре оболочки — v1 якорь в колонке зоны Mfd; бейджи PFD; команды палитры — без TabControl) задаётся пресетом и ADR 0021 отдельно от полосы IDE Health.
Детализация сигналов v1, состав полей и размещение в UI — в чертёже.
Последствия¶
- Новые фичи «показать состояние среды для IDE» развивают этот канал и документируют добавляемые имена env/проверки в чертеже или в коде со ссылкой на ADR.
- Расширение IDE Health новыми сегментами про LSP/env не делается под видом того же канала — при сомнении см. §Контекст и 0022.
Открыто¶
- Имя типов в коде (
EnvironmentReadiness*или иное) — при первой реализации. - Локализация заголовков страницы/карточки.