CDS — контракт «кабины» в CascadeIDE (чертёж v0)

Статус: живой чертёж (не ADR). Назначение: зафиксировать контрактный смысл CDS до разрастания кода и MCP, чтобы новые фичи расширяли один семантический слой, а не плодили параллельные «снимки внимания».

Связь: ADR 0036 — цепочка канал → CDS → композитор → поверхность (нормативная ось). ADR 0021 §1.1 — CDS / UiLayoutSnapshot, 0017 (мультиоконность, presentation), workspace-health-implementation-map-v1 (канал IDE Health — ортогонален CDS).

1. Зачем отдельный документ

• ADR 0021 задаёт принципы зон и внимания; этот файл — черновик полей агрегированного «состояния кабины» для API, тестов и агента.
• UiLayoutSnapshot остаётся слоем дерева контролов; CDS — слой семантики (что за кабина, без обхода визуального дерева).

2. Термины

3. Слои (не смешивать)

Источник правды сегодня и как сблизить с CDS

Сейчас каноническое состояние кабины в рантайме по-прежнему живёт в свойствах MainWindowViewModel (видимость колонок, активная страница оболочки Mfd, хост Mfd и т.д.); CDS — проекция в CockpitSurfaceState через CockpitSurfaceSnapshotBuilder — это уже язык для агента, тестов и наблюдаемости (ADR 0036 п. 2), не дубль «второй источник правды», если снимок детерминирован от VM.

Улучшать имеет смысл инкрементально:

1. Читать семантику кабины в тестах и инструментации прежде всего из Build(vm) / готового DTO, а не из россыпи полей VM.
2. Сужать мутации: страница shell, топология, хост — через узкий набор методов, чтобы после каждого шага снимок CDS оставался согласованным.
3. Позже — выделить явный агрегат «состояние навигации кабины» (один тип), из которого и биндинги, и билдер CDS читают одни и те же поля; полный перенос истины в отдельный сервис с подпиской VM — только при явной потребности (дорого).

4. Черновик полей v0 (эволюция)

Поля не обязаны совпадать с текущими именами свойств VM — это целевой контракт для стабилизации.

{
  "schema_version": "0.3",
  "ui_mode": "string",
  "presentation_effective_line": "string",
  "presentation_parse_success": true,
  "topology": {
    "surface_kind": "main_window_docked_grid | …",
    "mfd_host_window_open": false,
    "mfd_column_visible_in_main": true
  },
  "mfd_shell": {
    "current_page": "IdeHealth | Chat | Terminal | …"
  },
  "zones": {
    "pfd_visible": true,
    "forward_visible": true,
    "mfd_visible": true,
    "pfd_required_by_presentation": true,
    "forward_required_by_presentation": true,
    "mfd_required_by_presentation": true
  },
  "instruments": [
    {
      "instrument_id": "solution_explorer_tree",
      "slot_id": "pfd",
      "schema_version": "0.2"
    }
  ]
}

Намеренно узко v0: без дублирования каналов данных, без геометрии в пикселях (bounds — при необходимости отдельное расширение или слой 0017).

5. Версионирование

• schema_version — семантическое версионирование JSON (например 0.1, 0.2 при добавлении полей).
• Обратная совместимость для потребителей MCP: явно документировать в MCP-PROTOCOL.md, когда появится отдельный инструмент или расширение существующего.

6. Реализация (статус)

7. Связанные файлы кода (ориентиры)

• Cockpit/Cds/CockpitSurfaceState.cs, Cockpit/Cds/CockpitSurfaceSnapshotBuilder.cs — CDS (семантика кабины); Cockpit/Cds/AttentionLayoutSurfaceKind.cs — вид топологии в снимке.
• Cockpit/Composition/CockpitInstrumentDescriptor.cs — дескриптор инструмента слота (ADR 0047).
• Cockpit/Composition/Shell/MainWindowShellSurfaceCompositor.cs — метрики колонок shell.
• Cockpit/Composition/HostSurface/MainWindowHostSurfaceFrame.cs, MainWindowHostSurfaceCompositor.cs, CockpitHostSurfaceIds.cs — кадр для хоста (shell + инструменты); стабильные instrument_id / slot_id.
• Cockpit/Surface/MainWindowInstrumentMountRegistry.cs — реестр монтирования instrument_id → mount (хост-слой, вне композитора; Avalonia/Skia backend).
• Cockpit/Surface/UiLayoutSnapshot.cs — дерево UI (другой слой, ADR 0036 п.4).
• Каналы и композиторы по ADR 0036 — Cockpit/Channels/**, Cockpit/Composition/**.
• Services/Presentation/PresentationParser.cs, PresentationLayoutAnalyzer.cs — презентация.
• Views/MainWindow.axaml, MainWindow.PresentationHostWindows.axaml.cs — геометрия и жизненный цикл вторичных TopLevel (PFD/MFD).

Версия документа: 2026-04-17 — список файлов UI: MainWindow.PresentationHostWindows.axaml.cs для вторичных TopLevel (PFD/MFD). Ранее: 2026-04-16 — подраздел «Источник правды сегодня и как сблизить с CDS» (проекция из VM, инкрементальное улучшение). Ещё ранее: 2026-04-15 — v0.3: список instruments в CDS-снимке + реестр монтирования в Surface-слое.