spine` list|tree и статус в chrome (compact)¶

Статус: Accepted · Implemented
Дата: 2026-05-18

Связанные ADR¶

ADR	Роль
0119	Слэши в `ChatInput`; `kind=help` для `/help`; расширение `kind=report`
0123	Forward Intercom compact: toolbar Skia, лента без «чужого» Avalonia-хвоста
0120	После `/file open` — показ редактора (MFD Editor при `intercom`)
0125	`/file open` + autocomplete; клик по файлу → выполнение + `RevealEditorForOpenedDocument`
0072	Картотека тем (overview/detail) — визуальный режим
0096	Spine и topic cards — источник данных отчётов
0057	`ChatSurfaceSnapshot` — канон для list/tree

Вне ADR¶

Документ	Роль
`IntentMelody/intent-catalog.toml`	Маршруты `/topic list`, …, `kind = "report"`
`Features/Chat/ChatSlashSessionReports.cs`	Форматирование отчётов
`Features/Chat/ChatIntercomChromeStatusPresentation.cs`	Подзаголовок toolbar

Резюме¶

Текстовый inspect рядом с карточным overview (0072): слэши /topic list, /topic tree, /spine list, /spine tree — локальный отчёт в ленте (как /help), без MCP.
В compact Forward Intercom (0123) навигационный «хвост» (spine strip, «Темы → назад», боковые строки тем, заголовок ветки) убран из скролла; краткий статус — вторая строка toolbar (тема · линия · сообщений).
ChatSlashCommandExecutionKind.LocalReport + kind = "report" в TOML (без command_id, как help).

Картотека и кнопка «Темы» остаются для визуального drill-in; list/tree — для быстрого среза «что где» в одном текстовом блоке.

Контекст¶

После 0123 лента Intercom рисует spine strip, overview-навигацию и заголовки веток в начале скролла. При CompactLayout = true (Forward) это:

съедает вертикаль до сообщений и слэш-команд;
дублирует то, что уже есть в toolbar (Intercom, Темы) и в строке состояния.

Параллельно 0125 усилил workspace CLI; для структуры сессии (темы, spine) не хватало лёгкого текстового обзора без переключения в overview.

Проблема¶

Плотность: «хвост» из 3–4 карточек перед историей — антипаттерн Slack/MM-like ленты.
Дублирование: тема / spine / счётчик сообщений видны и в карточках, и в toolbar, и в ленте.
Нет быстрого inspect: overview — визуально; оператору нужен плоский список или дерево веток в чате (как git log --oneline vs git log --graph).

Решение¶

1. `kind = "report"` в slash-каталоге¶

Поле TOML	Значение
`kind`	`report`
`report_handler`	id в реестре `ChatSlashReportHandlers` (`topic_list_text`, `topic_tree_text`, `spine_list`, `spine_tree`)
`command_id`	не задаётся (как у `help`)
Исполнение	`ChatSlashCommandRunner` → `ChatSlashSessionReports.TryFormat(path, ChatSurfaceSnapshot)` → handler по `report_handler`

Маршруты (группа Intercom):

Слэш	Вывод
`/topic list text`	Плоский список тем: заголовок, `[main, active]`, число сообщений, короткий id
`/topic tree text`	Дерево по `ParentThreadId` (fork)
`/spine list`	Линия, фокус, вехи, флаг контекста агента
`/spine tree`	Линия → фокус → вехи

Данные — из текущего ChatSurfaceSnapshot (тот же compositor, что Skia-лента), не второй источник правды.

1b. `kind = "intercom"` — навигация (не только просмотр)¶

Поле TOML	Значение
`kind`	`intercom`
`intercom_handler`	id в реестре `ChatSlashIntercomHandlers` (`topic_list`, `topic_tree`, `topic_create`, `topic_open`, `topic_cards`, `spine_open`)
Исполнение	`ChatSlashCommandRunner` → `ChatSlashIntercomHandlers.TryExecute(intercom_handler, …)`

Слэш	Действие
`/topic list`	Интерактивный плоский picker в ленте (`SkiaChatTopicPickerEntity`); клик по строке → `SelectedChatThreadId`, picker сбрасывается.
`/topic tree`	То же, дерево по `ParentThreadId`.
`/topic create <название>`	Fork без `parent_message_id` + заголовок в `ChatSessionMetadata.ThreadTitles` (schema ≥ 2).
`/card <название>`	Алиас `topic_create` (`intercom_handler = topic_create`).
`/topic cards`	Картотека (overview): topic cards + spine; `IsChatOverviewMode = true`. Каноническое имя для 0072.
`/topic open`	Detail выбранной темы: `SelectedChatThreadId`, `IsChatOverviewMode = false`. Аргумент — заголовок, короткий id (8 hex) или пусто (выбранная/активная/main). Autocomplete: `completion = session_topics`.
`/spine open`	То же, что `/topic cards` (алиас).

После клика по подсказке /topic open … — автовыполнение (как /file open). Текстовый срез для агента — /topic list text / /topic tree text (kind=report); для UI-навигации — /topic list|tree или /topic open / /topic cards (или «Темы» в toolbar).

2. Compact chrome: статус вместо хвоста в ленте¶

При compactLayout && !overviewMode (ChatSurfaceEntityFactory):

не рисуются: spine strip, «Назад к обзору», боковые строки тем, заголовок активной ветки;
рисуются только сообщения / слэш-команды / уточнения.

В SkiaChatChromeRenderer (toolbar 52px при подзаголовке):

Intercom                                    [Темы]
тема: … · линия: … · сообщений: N

В режиме картотеки (overviewMode) — полоса «Картотека тем» под toolbar без изменения; подзаголовок: тем: N · atp/atn ….

2b. Редактор во вторичном контуре (Mfd / `MfdHostWindow`)¶

При primary_work_surface = intercom и вынесенном MfdHostWindow у одного файла может быть два TextEditor (скрытый Forward + видимый Mfd). EditorActiveDockResolver выбирает видимый экземпляр для TextMate, /editor line select, MCP select. TextMate ставится на каждый dock через MainWindow.EnsureDockEditorTextMate (не только при предке MainWindow).

3. Связь с 0125 (открытие файла)¶

После выбора файла в slash-autocomplete:

подстановка + автовыполнение /file open / /solution load (Enter и клик);
DocumentsWorkspaceViewModel.OpenOrActivateDocument → RevealEditorForOpenedDocument: при primary_work_surface = intercom — MFD Editor, фокус в редактор.

Это не часть LocalReport, но закрывает UX «файл открылся, а экран остался на Solution Explorer».

Альтернативы¶

Вариант	Почему нет
Только карточки, без list/tree	Нет быстрого текстового среза для агента/оператора в ленте
MCP `chat_list_threads`	Лишний round-trip; данные уже в snapshot
Оставить хвост в ленте + статус в toolbar	Дублирование и потеря плотности
Отдельное окно «Session inspector»	Избыточно для v1; слэш достаточен

Последствия¶

+ Лента compact начинается с сообщений; inspect по запросу.
+ Единый snapshot для Skia и отчётов.
− В compact нет боковых строк тем в ленте — Темы / /topic cards / интерактивный /topic list|tree (picker перед detail-лентой сообщений, не после).
Расширение: kind=report для /session tree (0116) — отдельно.

Критерии приёмки¶

[x] /topic list text, /topic tree text, /spine list, /spine tree — kind = report.
[x] /topic list, /topic tree, /topic create, /topic cards, /topic open, /spine open — kind = intercom; autocomplete тем для /topic open.
[x] Явные заголовки веток (ThreadTitles в metadata); partial ChatPanelViewModel.Threading.cs.
[x] Ответ в ленте как сообщение слэш-команды (успех + текст).
[x] Compact: нет spine/nav/заголовка ветки в скролле; подзаголовок toolbar с темой/линией/счётчиком.
[x] Тесты: ChatSlashSessionReportsTests, ChatThreadPresentationTests, ChatIntercomChromeStatusPresentationTests; каталог: intercom_handler / report_handler на всех маршрутах.
[x] Typed NDJSON payloads (ChatHistoryPayloads); legacy read в ChatHistoryMessageProjector для старых message_* / message_edited.
[x] MCP fork_chat_thread: опционально display_title / title → ForkThread(parent, title); SelectedChatThreadId синхронизируется с новой веткой.
[x] Пустые темы (только заголовок / fork без сообщений) видны в snapshot через ThreadDisplayTitles + ThreadForks.
[x] Слэш после fork (/topic create, /card, MCP fork) пишется в активную ветку (AssignThread).
[x] Intercom-ошибки (не найдена тема, пустой заголовок) — SlashCommandStatus.Failed, не Succeeded.
[x] Autocomplete включает новые пути (статический каталог).

Реализация (ориентиры в коде)¶

Компонент	Путь
Отчёты / презентация тем	`ChatSlashSessionReports.cs`, `ChatThreadPresentation.cs`, `ChatSlashReportHandlers.cs`
Intercom handlers	`ChatSlashIntercomHandlers.cs`, `ChatSlashIntercomActions.cs`, `ChatSlashTopicResolver.cs`
Статус toolbar	`ChatIntercomChromeStatusPresentation.cs`
Picker + порядок в ленте	`SkiaChatTopicPickerEntity.cs`, `ChatSurfaceEntityFactory.cs` (picker до detail lanes)
Сессия / ветки	`ChatPanelViewModel.Threading.cs`, `ChatPanelViewModel.Session.cs`
История	`Models/AgentChat/ChatHistoryPayloads.cs`, `ChatHistoryMessageProjector.cs`
Runner	`ChatSlashCommandRunner.cs`
Loader	`IntentCatalogLoader.cs` (`report_handler`, `intercom_handler`, `session_topics`)
Autocomplete тем	`SessionTopicSlashCompletionProvider.cs` (ранжирование по `State.Threads`)
TOML	`IntentMelody/intent-catalog.toml`

История¶

Дата	Изменение
2026-05-18	Accepted · Implemented: report slash, compact chrome status, cross-fix open file UX
2026-05-17	Review fixes: synthetic threads, thread_fork replay, slash thread assign, intercom Success

ADR 0126: Intercom inspect — /topic//spine list|tree и статус в chrome (compact)¶