| 1 | # ADR 0022: Лексикон и канон имён — IDE Health (эволюция названий; файл ADR сохранён как 0022) |
| 2 | |
| 3 | **Статус:** Accepted |
| 4 | **Дата:** 2026-04-11 |
| 5 | **Обновлено:** 2026-04-24 — крупный трек UI designer → [0092](0092-visual-ui-designer-major-track.md). Подробности — [§ История](#adr0022-history). |
| 6 | ## Связанные ADR |
| 7 | |
| 8 | | ADR | Роль | |
| 9 | |-----|------| |
| 10 | | [0021](0021-pfd-mfd-cockpit-attention-model.md) | модель внимания, канал vs слот презентации | |
| 11 | | [0010](0010-ui-modes-toml-configuration.md) | ключи TOML и capabilities | |
| 12 | | [0012](0012-floating-workspace-chrome.md) | размещение полосы и нижней зоны | |
| 13 | | [0089](0089-ide-omnibus-naming-and-ide-health-channel-rename.md) | **переименование** продукта и типов: *Workspace Health* → **IDE Health**, `WorkspaceHealth*` → `IdeHealth*` | |
| 14 | |
| 15 | ### Вне ADR |
| 16 | |
| 17 | | Документ | Роль | |
| 18 | |----------|------| |
| 19 | | [`workspace-health-implementation-map-v1.md`](../design/workspace-health-implementation-map-v1.md) | код и поток данных | |
| 20 | |
| 21 | --- |
| 22 | ## Контекст |
| 23 | |
| 24 | 1. Слово **telemetry** в английском UI и в инженерной речи перегружено: продуктовая аналитика, «телеметрия агента», приборные показания в метафоре кокпита и т.д. |
| 25 | 2. Канал **состояния задачи в workspace** (сборка, тесты, сессия отладки, git) нужен был с **устойчивым именем** в коде, конфиге и ADR без коллизий. |
| 26 | 3. Переименование **без обратной совместимости** для ключей TOML и типов проведено в репозитории; этот ADR фиксирует **решение и рамки**, а не пошаговую миграцию. **0089** зафиксировал смену **продуктового** имени на **IDE Health** и префикс типов **`IdeHealth*`**; wire-ключи режимов для этого контура — **`ide_health_*`** в TOML ([0010](0010-ui-modes-toml-configuration.md), `UiModes/*.toml`), ранее `workspace_health_*`. |
| 27 | |
| 28 | --- |
| 29 | |
| 30 | ## Решение (канон) |
| 31 | |
| 32 | | Слой | Канон | Русские формулировки в UI/доках | Где зафиксировано | |
| 33 | |------|--------|----------------------------------|-------------------| |
| 34 | | Продукт / ADR | **IDE Health** (ранее *Workspace Health*) | Рядом уместно **состояние IDE** / «сводка сборки и среды» (избегать путаницы с каталогом *workspace* на диске) | **0089**, этот ADR, **0021** §1.1–1.2 | |
| 35 | | Код | Префикс типов **`IdeHealth*`** (`IdeHealthSurfaceCompositor`, `IdeHealthStripView`, …); часть имён VM/привязок может ещё содержать `WorkspaceHealth*` до зачистки | — | Репозиторий, чертёж implementation map | |
| 36 | | Конфиг режимов | Ключи **`ide_health_*`** (`ide_health_strip`, `ide_health_surface`, `ide_health_on_terminal_tab`, `ide_health_main_column_span`) — wire-формат в TOML | — | **0010**, `UiModes/*.toml` | |
| 37 | |
| 38 | **Семантика:** один **канал смысла** (что происходит с задачей: build/tests/debug/git), несколько **слоёв представления** (полоса под редактором, страница MFD, дубль на вкладке терминала — по пресету). Композитор смысла — `IdeHealthSurfaceCompositor`; зона экрана и хром — по **0021** и пресетам. |
| 39 | |
| 40 | --- |
| 41 | |
| 42 | ## Не путать с IDE Health |
| 43 | |
| 44 | | Имя / ключ | Смысл | Почему не переименовывали в тот же заход | |
| 45 | |------------|--------|------------------------------------------| |
| 46 | | **`autonomous_agent_telemetry`** (TOML), **`AutonomousAgentTelemetry`** (capabilities) | Кокпит Power: явный доступ к **выводу** (терминал), подсказки при скрытом терминале | Другой продуктовый контур; слово *telemetry* здесь про «приборку/вывод сессии», не про канал build/tests/debug/git. См. **0010** и UX-таблицы. | |
| 47 | | Строки вроде **«Telemetry: on»** в UI | Привязка к терминалу в Power | Локализация и переименование свойств VM — отдельная задача. | |
| 48 | | Стабильные **id якорей** в markdown (напр. `#anchor-pfd-mfd-content-vs-telemetry-page`) | Постоянные ссылки из других доков | Менять ломает внешние ссылки; смысл якоря описан в **0021**. | |
| 49 | |
| 50 | --- |
| 51 | |
| 52 | ## Эволюция (кратко) |
| 53 | |
| 54 | | Было (устарело) | Стало (канон) | |
| 55 | |-----------------|---------------| |
| 56 | | Черновики: «телеметрия работы», «операционная телеметрия» | **IDE Health** / состояние IDE | |
| 57 | | `WorkspaceTelemetry*` | `IdeHealth*` (типы); ключи TOML `ide_health_*` | |
| 58 | | Ключи `telemetry_*` в TOML режимов | `ide_health_*` | |
| 59 | | Чертёж `workspace-telemetry-compositor-implementation-v1.md` | [`workspace-health-implementation-map-v1.md`](../design/workspace-health-implementation-map-v1.md) | |
| 60 | | Продуктовое имя *Workspace Health* | **IDE Health** ([0089](0089-ide-omnibus-naming-and-ide-health-channel-rename.md)) | |
| 61 | |
| 62 | История формулировок в шапках **0021** и в UX-доках может ссылаться на старые имена в **прошедшем времени** — это норма. |
| 63 | |
| 64 | --- |
| 65 | |
| 66 | ## Последствия |
| 67 | |
| 68 | - Новые фичи для этого канала — имена типов **`IdeHealth*`**, ключи TOML в **`[capabilities]`** — префикс **`ide_health_*`** ([0010](0010-ui-modes-toml-configuration.md)). |
| 69 | - Обзорные UX-доки: [`cascade-ide-ui-layout-v1.md`](../ui-ux/cascade-ide-ui-layout-v1.md), [`concept-to-implementation-map-v1.md`](../ui-ux/concept-to-implementation-map-v1.md), [`ui-modes-overview-v1.md`](../ui-ux/ui-modes-overview-v1.md) — выровнены по термину **IDE Health**; при расхождении **приоритет у 0089, этого ADR и 0021**. |
| 70 | |
| 71 | --- |
| 72 | |
| 73 | ## Открытые пункты (не блокируют канон) |
| 74 | |
| 75 | - Отдельное переименование **`autonomous_agent_*`** / строк UI, если продукт выберет единый английский глоссарий без «telemetry» для кокпита Power. |
| 76 | - Локализация RU/EN для всех видимых строк — вне скоупа этого ADR. |
| 77 | - Полная зачистка остаточных имён `WorkspaceHealth*` в VM/AXAML при отсутствии необходимости сохранять wire-совместимость для внешних интеграций. |
| 78 | |
| 79 | --- |
| 80 | |
| 81 | ## История изменений |
| 82 | |
| 83 | <a id="adr0022-history"></a> |
| 84 | |
| 85 | | Дата | Изменение | |
| 86 | |------|-----------| |
| 87 | | 2026-04-25 | TOML-ключи контура **IDE Health** в режимах: канон **`ide_health_*`** (см. [0010](0010-ui-modes-toml-configuration.md)). | |
| 88 | |