Перейти к содержанию

ADR 0199: Dual-agent isolation (client workspace primary)

Статус: Accepted · Implemented
Дата: 2026-07-27
Tags: #cdp #isolation #roots #witdb #adr #cascade-ide

Связанные ADR

ADR Роль
0182 Dual-instance deploy (cdp / cdp-debug)
0197 Wire gap (ортогонально)
0198 Toolchain; state-scoped recipes
0166 Habitat comfort

Резюме

  • Два агента в разных пространствах не делят WitDB / seats / pressure thrash.
  • Primary: MCP client roots (RequestRootsAsync) → state under %LocalAppData%/cdp-mcp/ws/<hash>/.
  • Fallback: session scm_root/ProjectRoot после cdp_open (тот же ws/<hash>/).
  • Override: CDP_PROFILE env (явный process profile) — когда roots недоступны или нужен ручной split.
  • Один mcp.json entry достаточен, если клиент отдаёт разные roots на разные окна/workspaces.

Контекст

v0 думал только про CDP_PROFILE + второй MCP entry. Это работает, но неуклюже при одном mcp.json. Изящнее брать workspace у клиента (MCP Roots).

Решение

Приоритет ключа изоляции

  1. CDP_PROFILE ≠ default → %LocalAppData%/cdp-mcp/profiles/{name}/
  2. иначе MCP client roots (sorted, hashed) → …/cdp-mcp/ws/{hash12}/
  3. иначе session project/scm → тот же ws/{hash}/
  4. иначе legacy flat …/cdp-mcp/ (kind=default)

Под StateRoot: intent-workspace.witdb, pressure-stash.json, ide-settings.json.

Поведение

  • CdpClientWorkspace.Wire(server): notification roots/list_changed + boot refresh.
  • CallTool: throttled refresh (~20s) + session fallback.
  • Смена StateRoot → invalidate settings cache + reopen WitDB на новом пути.
  • cdp_health.isolation — диагностика (kind, state_root, client_roots, last error).

Dual-instance

0182 остаётся для live vs dogfood. Isolation — для двух рабочих пространств.

Не делать

  • Требовать второй mcp.json как норму.
  • Считать peel DataBus заменой изоляции.

Последствия

  • Dogfood: два Cursor window с разными folder roots → разные ws/* без правки mcp.json.
  • Если Cursor не advertises roots: session fallback после cdp_open; иначе CDP_PROFILE.
  • cdp-mcp 0.5.251+.