ADR 0171: Presentation tiers — Compact (standard IDE) vs Cockpit

Статус: Accepted · Implemented (P0–P4)
Дата: 2026-07-10

Резюме

CIDE проектировалась с трёхмониторным cockpit (P)(F)(M) и пространственным scan pattern (P → F → M). На 1–2 обычных мониторах (16:9, ноутбук) попытка «впихнуть кабину» даёт узкие колонки, ложные PFD/MFD в MainGrid и плохой UX — при том же harness под капотом.

Принято направление:

1. Два presentation tier: compact (обычная IDE) и cockpit (полный P/F/M).
2. 1–2 стандартных экрана → default compact: не симулировать трёхзонную кабину колонками в одном окне.
3. cockpit — 3 монитора или cockpit-capable холст (UltraWide и аналоги с достаточной шириной для фиксированных якорей).
4. Harness (MCP, Intercom, AEE, FM, KB in-proc) — одинаковый в обоих tier; меняется только presentation policy и acceptance по scan/checklist.
5. Авиационная дисциплина внимания (ANC, dark cockpit для приборов) — в обоих tier; пространственный scan и scan-checklist — только cockpit.

0168 остаётся полезным переходным policy для topology (P+F)(M); этот ADR задаёт продуктовый tier выше: на compact P+F split не обязателен.

Связанные ADR

Вне ADR

Контекст

1.1 North-star vs реальность оператора

Операторский feedback (2026-07): CIDE интересна как harness, но много сырого в Intercom и layout; на 2 мониторах неудобно по сравнению с привычной IDE.

1.2 Число кабелей ≠ tier

UltraWide (32:9, 49", два логических canvas) — не «один монитор» в смысле compact, если ширина позволяет стабильные якоря с предсказуемым scan. Критерий — cockpit-capable width, не Screen.Count == 3.

1.3 Что не меняется

• Intercom wire, attachments, topics, slash, AEE, in-proc MCP.
• [workspace] primary_work_surface — default intercom (conversation-first); editor в Forward — compact presentation с Intercom в side/bottom panel.
• Авиация как язык дисциплины (не смешивать критичное с побочным) — не отменяется.

Решение

2.1 Два tier

2.2 Выбор tier

Настройка (целевая):

[display.presentation]
tier = "auto"   # auto | compact | cockpit

# Пороги для auto → cockpit на одном физическом экране (эвристика, уточняется)
cockpit_min_total_width_px = 4800
cockpit_min_anchor_width_px = 1280

auto (MLP):

Оператор всегда может tier = cockpit или compact вручную.

2.3 Compact — поведение (норматив)

Compact IDE-scan (presentation slots, семантика зон сохраняется):

compact_intercom_placement: side (default) — Intercom справа; bottom — Intercom снизу (над MFD при обоих видимых). Chat focus: toggle_primary_work_surface / primary_work_surface = intercom — Intercom на весь Forward (как Cursor maximize chat).

Команды (set_mfd_shell_page, focus_forward, /build) по-прежнему адресуют зону, не пиксели; compositor tier compact выбирает слот из таблицы выше.

Инвариант compact: пользователь узнаёт раскладку VS Code / Rider / Cursor — один главный canvas, панели по краям.

2.4 Cockpit — без изменений north-star

• (P)(F)(M) на трёх экранах — эталон 0017.
• Scan pattern P → F → M — design invariant (Comet note; 0021).
• 0168: если оператор явно держит cockpit tier на 2 экранах — PFD collapsed, SE/map на MFD; это исключение, не default path для новых пользователей.

2.5 UltraWide

Один кабель, cockpit-capable:

• Три логические зоны с фиксированными min-width на одном canvas или два logical viewport (OS «two displays on one panel»).
• Wizard: «Cockpit layout on ultrawide» vs «Compact».
• Не смешивать с compact только из-за Screen.Count == 1.

2.6 Связь с harness (0166)

Anti-pattern: откладывать читаемость Intercom 0170 «пока не cockpit» — compact как раз первый приоритет UX.

Фазы

Не цели

• Удаление cockpit tier или ADR 0017/0021.
• Отдельный продукт «CIDE Lite» — один бинарник, два presentation preset.
• Авто-migrate Cursor users в cockpit на ноутбуке.
• Vim/Emacs keymap — 0169.

Последствия

• defaults-settings.toml: при отсутствии явного topology для 1–2 screens — tier = compact, не (0.25P + 0.75F) (M) как единственный default.
• CockpitPresentationLayoutPolicy: ветка compact — не применять coercion «нельзя скрыть P/M якорь» 0046.
• Playbook layout: симптом «узкая полоса» на 2 mon → проверить tier; fix = compact, не только collapse PFD 0168.
• Тесты: PresentationTier.Compact → IsPfdColumnVisible == false, IsMfdColumnVisible == false в main at startup.
• Marketing / README: cockpit — power-user / 3-screen; compact — default для большинства.

История