ADR 0162: Monaco как опциональный хост Forward-редактора (WebView2, не Photino-shell)

Статус: Proposed
Дата: 2026-06-20
Обновляет: 0103 §2.3 — Monaco перестаёт быть «молчаливо отклонённым» baseline; становится явно разрешённой опциональной линией при включении в конфиге.

Связанные ADR

Вне ADR

1. Контекст

Продуктовая боль: Avalonia как фюзеляж приемлема (окна, dock, focus, OS integration), но текстовый UX Forward на AvaloniaEdit систематически слабее зрелых web-редакторов:

• рендеринг текста, caret, selection, scroll;
• IntelliSense / completion / hover / Quick Info — кастомный chrome, визуальный и поведенческий разрыв с VS Code-подобным опытом;
• inline HUD (squiggles, inlays, ghost) — дорогая борьба с IBackgroundRenderer и adorners в DockDocumentView.

0103 уже ввёл IEditorSurfaceAdapter и зафиксировал AvaloniaEdit как baseline; Monaco/WebView2 — «вне спайка v1». Субстрат HUD (SemanticProjectionPipeline, EditorHudEngine, DAL/CCU) не привязан к AvaloniaEdit — второй адаптер архитектурно ожидаем.

Внешние рекомендации (Photino / «лёгкий Electron»): часто смешивают три разных тезиса:

1. OS WebView легче упаковки Electron — верно;
2. «C# и JS в одном address space», «zero-latency IPC» — неверно для WebView2 (renderer out-of-process);
3. «30–40 МБ на IDE» — нереалистично для Monaco + нескольких поверхностей; память уходит в процессы Edge/WebView2, а не исчезает.

Photino-shell (весь UI в web) не требуется, чтобы снять боль редактора: достаточно Monaco-island в уже принятом WebView2 (Avalonia.Controls.WebView / NativeWebView, см. 0108).

2. Решение

2.1 Направление

1. Ввести MonacoWebViewSurfaceAdapter — реализация IEditorSurfaceAdapter поверх Monaco Editor во встроенном WebView2 в слоте DockDocumentView (Forward), без миграции всего CIDE на Photino.

2. Avalonia остаётся фюзеляжом: dock, окна, terminal, Skia-острова (Intercom, cockpit), MFD — без изменения 0044 / 0123.

3. Strangler dual-path (0009): конфиг [editor].forward_host = avalonia_edit (default) | monaco_webview2. Переключатель на уровне workspace или глобально в settings.toml; без silent fallback между хостами на одном документе.

4. LSP, Roslyn, DAL, agent MCP — без изменения контрактов; только транспорт текста/offsets/decorations через адаптер.

2.2 Что не делаем

• Полный Photino-shell (все панели в HTML) — отдельная линия, не блокер и не замена этого ADR.
• Electron — не рассматриваем (bundled Chromium).
• WebView для forge write path — по-прежнему FORGE ADR-0002 / CIDE native; Monaco — редактор кода, не forge SPA.
• Monaco как единственный default — только после явного sign-off parity (фазы ниже).

2.3 Инварианты (не ломать)

• 0084: канонический текст для apply — версионированный буфер; Monaco не «тихий master» без sync protocol.
• 0085: inline и banner — разные слои; маппинг на Monaco deltaDecorations / content widgets / overlay, не один DOM-хак.
• 0103 §2.2: hi-freq caret/pointer — bounded channel + throttle, не DataBus на каждую клавишу.
• 0035: origin редактора — cide-editor:// / bundled asset, не произвольный HTTPS; Host Object allowlist отдельный от Web AI Portal (0108).

3. IPC и память (честные ожидания)

3.1 WebView2 — не «zero latency»

3.2 Память

• Пустое окно Photino/WebView — десятки МБ; IDE + Monaco + language services + N webviews — сотни МБ суммарно по процессам Edge — норма.
• Выигрыш vs Electron — не тащим свой Chromium; vs AvaloniaEdit-only — дополнительный renderer process на Forward-документ.

4. Контракт cide-editor (мост C# ↔ Monaco)

Namespace сообщений: cide-editor/* (ортогонально executeIdeCommand из 0108).

Транспорт: WebMessageReceived + опционально Host Object для sync read (caret snapshot); JSON camelCase.

Минимальный набор (v0):

Source of truth (0084): v0 — C# master: push setModel / applyEdits после локальных и agent mutations; JS шлёт deltas, C# мержит и инкрементирует version. Инверсия (Monaco master) — только с отдельным ADR и тестами race.

Assets: bundled static (Assets/editor/ или wwwroot/cide-editor/), загрузка через WebView2 virtual host или file:// под контролируемым path — детали реализации, origin не third-party.

5. Фазы внедрения (strangler)

Dual-path до M6: AvaloniaEdit не удаляем; regression на avalonia_edit для CI matrix optional.

6. Последствия

Положительные

• Текст, selection, completion UI, diff editor — зрелый API Monaco; снимает класс боли AvaloniaEdit без смены фюзеляжа.
• Переиспользование WebView2-инфраструктуры и паттернов 0108.
• IEditorSurfaceAdapter и Editor HUD substrate получают реальную вторую реализацию — проверка абстракции.

Отрицательные / trade-offs

• Две темы (Avalonia + Monaco CSS) — генератор из канона 0086, не ручной drift.
• IPC-latency на hi-freq path — дисциплина throttle; возможен micro-jank vs native.
• DockDocumentView strangler: AvaloniaEdit-specific renderers отмирают по inventory, не одним PR.
• Windows-first (текущий win-x64 RID); Linux/macOS WebView — отдельный roadmap (0093), не блокер Proposed.

7. Отклонённые альтернативы

8. Конфиг (sketch)

[editor]
# avalonia_edit | monaco_webview2
forward_host = "avalonia_edit"

Per-workspace override — через существующий stack settings.toml / workspace profile (детали при M1).

9. Ownership (sketch)

История изменений