ADR 0172: Session graph habitat — Intercom как рабочая память сессии

Статус: Proposed (концепт / north-star)
Дата: 2026-07-10
Обновлено: 2026-07-12 — habitat ≠ TOML axis; G1 = primary_work_surface default; session_graph prefs — future UI only

Резюме

Часть операторов живёт почти целиком в Intercom; редактор — по attach/reveal. Их stance — conversation-first 0120.

Моат CIDE — не «ещё один чат», а нелинейная сессия: темы, ветки, rewind, scope на экране 0031, 0116. Линейная flat feed — проекция одной ветки, не единственная правда.

0171 задаёт tier (compact/cockpit). 0172 задаёт habitat (имя session-graph canvas в глоссарии) для conversation-first: Session graph canvas в Forward, код on demand. Habitat — не ось settings.toml; продукт conversation-first выражается через primary_work_surface = intercom 0120.

Принято направление (концепт):

1. Session graph habitat — Forward = Intercom canvas (scope + worklines + tree/timeline); не отдельный переключатель habitat = … в TOML.
2. Topics = worklines index — параллельные ThreadNode 0072; не аналог Cursor New Chat.
3. Detail default — scope strip + Tree | Timeline; flat feed только для выбранной ветки 0170.
4. Composer modes: continue · steer · follow-up 0116.
5. Harness неизменен 0166.

Design thesis

Классические IDE заточены под написание кода: редактор в центре, а сопутствующее — решения, intent, история рассуждения, «почему так» — размазано по боковым панелям, файлам в репо и внешним тредам, и читается плохо. В agentic-цикле писать код в основном берёт на себя агент; работа человека смещается к пониманию, направлению и фиксации решений. Редактор не исчезает — он для проверки и точечных правок, когда нужно руками.

Session graph habitat — ответ на эту ось: Intercom — не «ещё один чат», а инфраструктура восприятия сессии (ветки, scope, worklines, batches). Moat — удобство читать и управлять нелинейной работой, а не паритет линейной ленты с Cursor.

Связанные ADR

Дифференциация от линейного agent chat (Cursor и аналоги)

Anti-pattern moat loss: topics как список чатов + только flat feed в detail → паритет с Cursor без нелинейности.

Контекст

Три оси (не смешивать)

Tier (пространство)   : compact | cockpit          ← [display.presentation] tier
Forward [0120]        : intercom | editor            ← [workspace] primary_work_surface
Stance (продукт)      : session-graph-first          ← не TOML; Agent/Intent/Conversation-first

Не путать: Habitat в глоссарии = имя canvas (scope + worklines + tree/timeline), не четвёртая ось настроек рядом с tier и primary_work_surface.

Оператор session-graph-first

| ~99% | Intercom canvas: worklines, scope, tree/timeline, composer | | Редко | Editor reveal из attach | | Фон | Solution warmup; не SE tree вместо чата после load_solution |

Решение

1. Session graph canvas (не «lanes + feed»)

┌─ Scope: N branches · open batch · last decision @msg ─────────┐
│ Worklines │  [ Tree ] [ Timeline ]                              │
│  index    │   graph of selected topic / branch                   │
│  (rows)   │   + flat feed (THIS branch only, measure cap)        │
├───────────┴──────────────────────────────────────────────────────┤
│ Composer: Continue | Steer | Follow-up  +  slash                 │
└──────────────────────────────────────────────────────────────────┘
              Code · Terminal — on demand (MFD / mon2 / reveal)

2. Слои UI

3. Инварианты

4. Мониторы

1 × 16:9

Forward ~90% = полный session canvas (index + scope + tree/timeline + composer).

2 × 16:9 (operator default)

Не (P+F)(M) cockpit.

5. Настройки (целевые)

[workspace]
primary_work_surface = "intercom"   # conversation-first default [0120]

[display.presentation]
tier = "compact"
# compact_intercom_placement = "side" | "bottom"  — см. [0171](0171-presentation-tiers-compact-vs-cockpit.md)

# Будущие UI-префы session graph (не ось habitat):
# [display.presentation.session_graph]
# workline_rail_width_px = 200
# feed_max_measure_ch = 72
# detail_default_view = "tree"   # tree | timeline
# overview_style = "rows"

[intercom]
feed_metrics = "comfortable"

Убрано из target settings: habitat = "session-graph" — продукт уже conversation-first; отдельный runtime knob дублировал бы primary_work_surface и tier.

6. Anti-patterns

7. Concept vs implementation ladder

Wireframe v2 — north-star poster, не acceptance criteria для первого PR. На кадре всё уже случилось: scope заполнен, tree и timeline согласованы, worklines с branch count, пустые состояния скрыты. В коде слои появляются по фазам; сравнение poster ↔ G1 почти всегда выглядит как «фиаско», хотя это непровал moat, а незавершённая лестница.

Два класса артефактов:

Что ожидать по фазам (намеренно «уродливо» — ок):

Реальный провал moat (стоп-кран, не «ещё не дорисовали»):

• Detail застрял только на timeline без плана G3 (anti-pattern §6).
• Topics = New Chat / линейные сессии вместо worklines.
• Нет parent_id/ветки в log, но UI притворяется session graph.
• Сравниваем с wireframe и откатываем G2–G4 ради «красивой ленты».

Порядок работ: сначала data (event log, parent_id, head, branch path 0116), потом chrome. Timeline (Skia feed) уже есть — tree/scope надстраиваются, не переписывают Intercom с нуля.

Один инвариант за спринт — не «habitat как v2», а например: «scope strip с N branches + open batch» (G2) или «toggle + continue from на одной workline» (G3).

8. API boundary (stateless FM)

Session graph — клиентская модель. Cloud.ru Foundation Models и любой OpenAI-compatible провайдер — stateless POST /v1/chat/completions: массив messages[], опционально tools. API не знает topics, tree, timeline, steer/follow-up, session_id от CIDE.

┌──────────────── CIDE (локально) ─────────────────┐
│  Event log NDJSON     ← канон [0045]               │
│  Session tree         ← parent_id, branch, head    │
│  Worklines / scope    ← продуктовые проекции       │
│         │                                          │
│         ▼                                          │
│  Orchestrator                                      │
│    · messages[] только для АКТИВНОЙ ветки          │
│    · ContextMinimizer / compactor [0166]           │
│    · MCP tools → ide_execute_command               │
│    · steer / follow-up → семантика вставки user    │
└─────────┼──────────────────────────────────────────┘
          ▼
┌──────────────── Cloud.ru FM (stateless) ───────────┐
│  messages: [system, user, assistant, tool, …]      │
│  stream; нет branch_id / rewind на стороне API     │
└────────────────────────────────────────────────────┘

Один ход: user msg → событие в log → проекция пути root → head → orchestrator собирает messages[] (только эта ветка; соседние ветки не жгут токены 0166) → stream FM → message_completed с parent_id = текущий head → tool loop при function calling.

Fork / continue from: меняется head и parent_id нового сообщения; следующий request несёт другой путь — без переписывания истории на стороне API (её там нет). Pay-per-token: нелинейность — экономия, не overhead.

Конфиг провайдера (пример): [ai.cloud.openai] base_url = https://foundation-models.api.cloud.ru; harness 0166 не меняется от habitat.

9. Worklines — ретро-проекция, не форум

Оператор не обязан создавать тему до разговора. Один composer, один поток реплик — как в обычном чате. Workline — имя и граница уже идущей линии работы, которую система и агент выводят из event log (и при необходимости уточняют одной фразой).

Anti-pattern: обязательный title/summary или New-Chat-подобный вход перед первым сообщением.

10. Переключение worklines и доделывание хвостов

Переключение строки в worklines index — смена фокуса, не новая сессия. У каждой workline свой head в session tree; при возврате head сохранён.

Оператор кликает workline B
  → timeline = flat feed ветки B до head_B
  → tree/scope = проекция workline B
  → composer пишет в B (новые события — потомки head_B)
  → orchestrator: messages[] только путь active workline

Доделать в старой линии: зайти в workline → закрыть open item (коммит, smoke, ADR) → при желании отметить в meta «closed» → вернуться в предыдущую workline (parked, head не сдвинулся). Scope strip показывает несколько open worklines без слияния их в один prompt.

Статусы в индексе (продуктовые, не обязательный протокол): active · parked · open count на строке.

11. Spin-off — вынесение диапазона сообщений

Когда линия внутри workline или целый смысловой блок вырос в отдельную работу, стороны договариваются в чате, система фиксирует событие (канон 0045):

1. Предложение (user или agent): «вынести msg A…B в workline X?»
2. Согласие или отказ одной короткой репликой
3. Событие spin_off (имя в log уточняется при реализации):
     source_workline, target_workline, msg_range, agreed
4. Проекция: сообщения rehome в target; в source — collapsed marker

UI в timeline (активная ветка source): system card / спойлер, свёрнут по умолчанию:

┌─ Вынесено в «VDS» (msg 840–1020) ─── [перейти] [развернуть] ─┐
└───────────────────────────────────────────────────────────────┘

Сообщения не удаляются из log; меняется принадлежность workline и материализация prompt. Отказ на шаге 2 — no-op, лента без изменений.

Отличие от fork branch: fork — ветвление внутри workline (tree); spin-off — перенос диапазона в другую workline (или новую).

12. Materialization для агента (двухслойный роутинг)

Ограниченный контекст FM и дефицит внимания оператора — одна экономика. Агент не «живёт во всём графе»; habitat задаёт, что попадает в ход.

Соседние ветки и worklines не входят в messages[], пока не станут активными. Scope strip и one-liner в system — сжатая карта («2 open worklines»), не полный dump. Решения и checkpoint — KB / export, chat context — кэш.

Workline может нести intent tag (например cascade-ide/habitat) → bias для route_context и MCP pull без чтения всей сессии.

Intent card 0173 — типизированная фиксация решения внутри workline (outcome, trigger, considered[], chosen_approach + selection_rationale); не заменяет intent tag и не равна ADR. В лестнице SEDM 0174 — артефакт T1; context card (T2) — Perceive для файла в scope strip.

Фазы

Приоритет moat: G2–G4 выше ширины панели и hero polish.

Визуальный концепт

• v1 (устарел для moat): cide-conversation-habitat-concept.png
• v2 (актуальный): cide-session-graph-habitat-concept-v2.png

North-star:

Одна сессия — много линий и веток; scope и tree на экране; лента — вид одной ветки; код по attach.