ADR 0161: CIDE spine + vertical Forge feature module

Status: Accepted
Date: 2026-06-13
Related: 0005, 0006, 0024, 0153–0160, FORGE-ADR-0015 (agent-forge)

Резюме

• Spine CIDE — editor, slash runtime, cockpit/shell, CascadeIDE.Contracts, bundled intent-catalog.toml (не forge).
• Vertical slice Forge — один in-solution модуль владеет всем клиентским срезом forge: connect, capabilities overlay, execute, CRS Lens, MCP handlers, bracket refs.
• Не MEF (0005): code-first ICascadeFeatureModule (0024); dynamic DLL-host — позже, те же контракты.
• Catalog: bundled TOML + runtime overlay (0160); forge SSOT = GET /api/v1/capabilities.

Контекст

Forge на host уже vertical plugins (FORGE-ADR-0015): Issue, MR, ViewShell, capabilities.commands[].

CIDE — второй клиент того же DOI-каталога, не дублирующий TOML. 0160 закрыл Phase D (overlay + execute).

Сейчас forge-код размазан по репо (работает, но ownership неочевиден):

Без явного vertical module следующий zoo-контур (Intercom-style) снова размажет handlers.

Решение

1. Spine (MIT, не выкидыается)

Spine — то, без чего IDE не IDE и что не принадлежит одному backend:

Правило: spine не знает forge REST paths; только контракты (ICascadeFeatureModule, slash merge hook, MCP dispatch table).

2. Vertical slice = Features/Forge (ownership)

Целевой владелец forge-клиента в CIDE — неймспейс CascadeIDE.Features.Forge (папка Features/Forge/).

Vertical slice владеет:

Не владеет: issue/MR server schema, WitDB, web ViewShell — forge-host (agent-forge).

3. Регистрация (0024, без MEF)

Каждый vertical module реализует ICascadeFeatureModule (когда 0024 wire завершён; до wire — явный ForgeFeatureRegistration в composition root):

// Sketch — CascadeIDE.Contracts.Experimental
public interface ICascadeFeatureModule
{
    string Id { get; }  // "forge"
    void Register(ICapabilityRegistry registry);
}

Forge module регистрирует:

• CommandCapability — bundled paths не дублируют /forge * (0160)
• ServiceCapability — IForgeConnectionService, overlay refresh
• hooks: ISlashCatalogContributor (overlay), IMcpHandlerContributor

Dynamic plugins (0005): тот же ICascadeFeatureModule, загрузка DLL — отдельный ADR после стабилизации cockpit slots (0021, 0025).

4. Параллель Forge ↔ CIDE

5. Миграция (incremental, не big-bang)

Не блокер: F2–F5 можно параллелить с cockpit; overlay уже работает в F0.

6. Guardrails (CASCOPE parity)

По духу FORGE-ADR-0015 §8 и CascadeIDE.ArchitectureAnalyzers:

• /forge * paths only from overlay when connected — не в bundled intent-catalog.toml
• новые forge MCP tools — только в Handlers.Forge / Features/Forge
• FORGE drift (dev): optional export capabilities → CI diff (0155)

Последствия

Positive

• Один ownership для forge-клиента; проще Phase D maintenance и zoo.
• Spine остаётся lean; forge = opt-in via [workspace.forge].
• Готовность к plugin-host без смены mental model.

Negative / trade-offs

• F2–F3 — churn namespaces/imports (done 2026-06-13).
• До полного wire capability-map forge MCP уже централизован в ForgeFeatureModule; descriptor registration — по мере 0025.

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

Связь с agent-forge