@goodandready/dsh-session-control 0.1.0 → 0.1.1

package/README.md

@@ -1,147 +1,146 @@
 # @goodandready/dsh-session-control
 
-Управление сессиями в боковой панели DeepSeek Harness: закрепление нужных
-диалогов, поиск по содержимому, чтение архивных разговоров и уборка шума.
+[English](README.md) | [Русский](docs/README.ru.md) | [中文](docs/README.zh.md)
 
-## Что плагин делает с панелью
+[![npm version](https://img.shields.io/npm/v/@goodandready/dsh-session-control.svg?style=flat-square)](https://www.npmjs.com/package/@goodandready/dsh-session-control)
+[![npm downloads](https://img.shields.io/npm/dm/@goodandready/dsh-session-control.svg?style=flat-square)](https://www.npmjs.com/package/@goodandready/dsh-session-control)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![DeepSeek Harness](https://img.shields.io/badge/DSH-Plugin-blue.svg?style=flat-square)](https://goodandready.app)
 
-Плагин **заменяет тело боковой панели** — блок со списком рабочих папок.
-Остальная панель остаётся штатной: бренд, кнопка новой сессии, подвал и вход в
-настройки не затрагиваются.
+Advanced session management for the **DeepSeek Harness** sidebar: pin essential conversations, search conversation contents with match snippets, read archived transcripts in an isolated modal, hide noise, and manage multiple sessions with bulk actions.
 
-Заменяет, а не дополняет, вынужденно: слот `sidebar.workspaces` объявлен ядром
-как `kind: "single"`, второго регистранта у него не бывает, а другого слота в
-теле панели нет.
+---
 
-## Чем отличается от штатной панели
+## What the Plugin Does to the Sidebar
 
-| | Штатная панель | С плагином |
+The plugin **replaces the body of the sidebar** — the section containing the workspace and session lists. The rest of the sidebar remains completely stock: branding, the new session button, footer, and navigation to settings remain untouched.
+
+Replacement is intentional and architecturally required: the `sidebar.workspaces` slot is declared by the harness core as `kind: "single"`, which does not allow secondary registrants, and no other extension slots exist in the sidebar body.
+
+---
+
+## Comparison: Stock Sidebar vs. dsh-session-control
+
+| Capability | Stock Sidebar | With `dsh-session-control` |
 |---|---|---|
-| Закрепление диалогов | нет | есть, общее на всю панель |
-| Архив | не виден нигде | отдельный раздел, разбитый по периодам |
-| Чтение архивной сессии | невозможно | расшифровка только на чтение |
-| Результаты поиска | только заголовок строки | плюс фрагмент с совпадением |
-| Пустые сессии | вперемешку с рабочими | скрыты, кроме текущей |
-| Действия над пачкой строк | нет | выбор галочками, Shift для диапазона |
-| Скрыть лишнее | только архив, необратимо | обратимое скрытие |
-| Индикатор работающей сессии | не показан | точка в строке |
-| Переименование | диалогом | по двойному клику в строке |
+| **Pin Conversations** | ❌ None | ✅ Global pinned section at the top of the sidebar |
+| **Archive Section** | ❌ Completely hidden | ✅ Dedicated section grouped by time periods |
+| **Read Archived Sessions** | ❌ Impossible | ✅ Read-only full transcript viewer modal |
+| **Search Results** | ⚠️ Title only | ✅ Title + contextual match snippet preview |
+| **Blank Sessions** | ⚠️ Mixed with active ones | ✅ Hidden automatically (except current active session) |
+| **Bulk Actions** | ❌ None | ✅ Multi-selection with checkboxes and Shift+Click ranges |
+| **Reversible Hiding** | ❌ Only irreversible archive | ✅ Reversible one-click hide / unhide |
+| **Active Session Indicator** | ❌ Not indicated | ✅ Live running pulse dot in row |
+| **In-Place Rename** | ⚠️ Modal prompt | ✅ Inline double-click or F2 edit |
+
+> Standard harness features — workspaces, deep conversation search, and branching sessions — remain fully intact: the plugin reuses and enhances them rather than reinventing them.
 
-Штатные возможности — рабочие папки, поиск по содержимому диалогов, ответвление
-сессии — остаются на месте: плагин их переиспользует, а не переписывает.
+---
 
-## Установка
+## Installation
+
+Install via the `dsh` CLI for your web profile:
 
 ```bash
 dsh plugin --profile web add @goodandready/dsh-session-control
 ```
 
-## Как вернуть штатную панель
+Restart the DeepSeek Harness web profile to activate the bundle patch.
+
+---
+
+## How to Restore the Stock Sidebar
+
+To revert to the stock sidebar at any time:
 
 ```bash
 dsh plugin --profile web remove @goodandready/dsh-session-control
 ```
 
-Штатный ряд `ui-workspace` включается обратно, панель возвращается к исходному
-виду. Закрепления и скрытия остаются в настройках и подхватятся, если плагин
-поставить снова.
+The stock `ui-workspace` row is instantly re-enabled, returning the sidebar to its default look. All pinned and hidden session preferences are preserved in host storage and will seamlessly reapply if the plugin is installed again.
 
-## Возможности
+---
 
-**Закрепление.** Нужные диалоги отдельной группой сверху, общей на всю панель.
-Переживают перезагрузку, смену браузера и устройство: настройки хранятся на
-хосте.
+## Features
 
-**Поиск с фрагментом.** Ядро ищет по содержимому диалогов и возвращает кусок
-текста вокруг совпадения — плагин показывает его второй строкой, поэтому видно,
-чем именно нашлась строка, без открытия сессии.
+### 📌 Pinned Sessions
+Pin important conversations to a dedicated, globally visible top group above workspaces. Pinned sessions survive page reloads, browser switches, and device migrations because configuration is persisted in host storage.
 
-**Архив по периодам.** Сегодня, на этой неделе, в этом месяце, раньше.
-Свёрнутый период не рисуется вовсе, поэтому сотни архивных строк не попадают в
-разметку разом. При активном поиске периоды раскрываются, чтобы совпадения не
-прятались за свёрнутым заголовком.
+### 🔍 Search with Contextual Snippets
+The core searches conversation contents and returns context around the matching query — `dsh-session-control` displays this preview as a second line under the session title so you immediately see why a conversation matched without opening it.
 
-**Расшифровка архивной сессии.** Заархивированную сессию нельзя открыть в
-беседе — ядро снимает выбор с такой сессии. Плагин показывает её содержимое
-отдельным окном, только на чтение.
+### 🗄️ Period-Based Archive
+Organized into intuitive collapsible periods: *Today*, *This Week*, *This Month*, and *Older*. Collapsed periods are unmounted from the DOM, preventing performance degradation even with thousands of historical sessions. Active search automatically expands relevant periods.
 
-**Скрытие пустых.** Сессии без единого сообщения непрерывно создают расписания,
-мессенджеры и доски. Они не показываются; текущая сессия не прячется никогда,
-даже пустая. Переключатель в карточке настроек возвращает прежнее поведение.
+### 📜 Read-Only Archived Transcript Viewer
+Archived sessions cannot be opened for active chatting in the core. The plugin provides an isolated, read-only transcript viewer modal via `GET /dsh-session-control/transcript?session=<id>` to inspect past agent turns, tools called, and user prompts safely.
 
-**Обратимое скрытие.** Своё, в отличие от ядрового архива: скрытое возвращается
-одним нажатием.
+### 🧹 Automatic Noise Reduction (Hide Blank Sessions)
+Automated schedulers, messenger gateways, and kanban boards continuously spawn sessions without messages. Blank sessions are hidden by default to keep the sidebar clean. The active session is never hidden even if empty. Toggleable via settings.
 
-**Множественный выбор.** Галочка при наведении, Shift берёт диапазон. Над
-выбранным доступны скрытие, возврат и закрепление.
+### 👁️ Reversible Session Hiding
+Unlike core archiving which is one-way, `dsh-session-control` offers lightweight reversible hiding for active sessions you temporarily want out of view.
 
-**Переименование по месту.** Двойной клик по заголовку или F2.
+### ☑️ Multi-Select & Batch Operations
+Hover checkboxes and Shift+Click range selection allow batch hiding, unhiding, and pinning of dozens of sessions simultaneously.
 
-## Настройки
+### ✏️ In-Place Inline Renaming
+Rename conversations instantly with a double click on the title or by pressing `F2`.
 
-Карточка в «Настройки → Плагины → Настройки плагинов». Пространство настроек —
-`dsh-session-control`:
+---
 
-| Поле | Смысл |
-|---|---|
-| `pinned` | закреплённые сессии, порядок массива = порядок в панели |
-| `hidden` | скрытые сессии |
-| `hideBlank` | прятать сессии без сообщений (по умолчанию да) |
+## Configuration
 
-Настройки хранятся на хосте, поэтому переживают смену браузера и устройство.
+Navigate to **Settings → Plugins → Plugin Settings → Session Control**:
 
-## Чего плагин не умеет
+| Setting | Type | Default | Description |
+|---|---|---|---|
+| `pinned` | `string[]` | `[]` | Array of pinned session IDs (array order determines display order) |
+| `hidden` | `string[]` | `[]` | Array of reversibly hidden session IDs |
+| `hideBlank` | `boolean` | `true` | Automatically hide sessions with zero messages |
 
-**Переносить диалог в другую рабочую папку.** Рабочая папка — это каталог, а
-членство сессии выводится из её рабочего каталога: реестр отвергает сессию, чей
-`cwd` не совпадает с путём папки. Это не пробел в API, а устройство модели, и
-поэтому такого пункта нет и в штатной панели.
+All settings are stored on the host and synchronize across client instances.
 
-**Возвращать из архива.** Ядро умеет только помещать в архив; метода возврата в
-API нет. Архивная сессия доступна на чтение, но вернуть её в папку нельзя.
+---
 
-**Читать очень старые журналы.** Часть архивных сессий хранится в раннем
-формате, который ядро отказывается читать. Такие показываются с пояснением, а
-не с ложным «нет сообщений».
+## Intentional Constraints
 
-**Удалять сессии.** Удаления нет ни в одном публичном интерфейсе ядра, и плагин
-его не изобретает.
+* **No cross-workspace session moving:** Workspaces represent distinct disk directories. Session membership is derived directly from the session's working directory (`cwd`). The core registry strictly enforces this binding.
+* **No unarchiving:** DeepSeek Harness core provides an archive operation but no unarchive API method. Archived sessions remain accessible via the read-only transcript viewer.
+* **Legacy log format handling:** Older legacy session logs that cannot be deserialized by the core are gracefully flagged with descriptive notices rather than displaying a false "no messages" state.
+* **No session hard deletion:** Session deletion is not exposed in public harness APIs, and the plugin adheres strictly to safe API contracts.
 
-## Устройство
+---
 
-Плагин собран из двух независимых половин, и это требование безопасности, а не
-украшение архитектуры.
+## Architecture & Reliability
 
-Заменяемый ядровый модуль попутно отдаёт служебный сервис `uiWorkspace`,
-который стоит в обязательных зависимостях у модулей боковой панели и интерфейса
-беседы. Если его не отдать, приложение не поднимется вовсе.
+The plugin utilizes a decoupled **two-half architecture** for maximum resilience:
 
-- **Половина «сервис»** отдаёт `uiWorkspace` и корневой хук списка папок. Без
-  React, без логики плагина, без настроек.
-- **Половина «интерфейс»** — список, расшифровка, карточка настроек. Целиком в
-  защитной обёртке.
+1. **Service Half (`uiWorkspace` Provider):**
+   * The replaced core `ui-workspace` module exports a required service `uiWorkspace` that is an essential dependency for `dsh-client-ui-sidebar` and `dsh-client-ui-conversation`.
+   * The plugin's service half delivers this service and root hooks cleanly with zero React rendering and zero plugin logic overhead.
+2. **Interface Half (UI & Views):**
+   * Encapsulates the custom workspace tree, search results, transcript modal, and settings card.
+   * Completely wrapped in defensive error boundaries. If a UI exception occurs, the main sidebar, conversation pane, and settings remain fully operational.
+3. **Server Route:**
+   * Exposes `GET /dsh-session-control/transcript` to parse and stream archived JSONL session logs safely without loading heavy unneeded payloads.
 
-Отказ интерфейса оставляет тело панели пустым, но панель, настройки и беседа
-продолжают работать.
+---
 
-Серверная половина добавляет один маршрут — расшифровку архивной сессии. Все
-остальные действия идут через штатные вызовы ядра.
+## UI Localization
 
-## Язык интерфейса
+The plugin core ships with English strings by default. Multilingual localizations (including Russian and Chinese) are loaded through language packs (such as `@goodandready/dsh-russian-lang`). Dictionary registration is fail-safe and never degrades sidebar functionality.
 
-Плагин везёт только английский. Переводы поставляются отдельным языковым
-плагином; регистрация словаря защищена и не может уронить панель, если
-пространство уже занято.
+---
 
-## Совместимость
+## Compatibility
 
-Проверен на ядрах `0.1.2-rc.1` и `0.1.3-alpha.1`. Плагин опирается на контракт
-слотов боковой панели и на поверхность сервиса `uiWorkspace`; при смене этого
-контракта потребуется правка.
+- Tested with DeepSeek Harness `0.1.2-rc.1` and `0.1.3-alpha.1`.
+- Compatible with Node.js `^20.19.0` or `>=22.12.0`.
+- Seamlessly integrates alongside `@goodandready/dsh-lanmode`, `@goodandready/dsh-kanban`, `@goodandready/dsh-cron`, and other DSH plugins.
 
-Поверхность хранилища сессий у разных выпусков ядра различается, поэтому плагин
-спрашивает бэкенд, какие методы у него есть, а не полагается на номер версии.
+---
 
-## Лицензия
+## License
 
-MIT
+MIT © GoodAndReady

package/docs/README.ru.md

@@ -0,0 +1,146 @@
+# @goodandready/dsh-session-control
+
+[English](../README.md) | [Русский](README.ru.md) | [中文](README.zh.md)
+
+[![npm version](https://img.shields.io/npm/v/@goodandready/dsh-session-control.svg?style=flat-square)](https://www.npmjs.com/package/@goodandready/dsh-session-control)
+[![npm downloads](https://img.shields.io/npm/dm/@goodandready/dsh-session-control.svg?style=flat-square)](https://www.npmjs.com/package/@goodandready/dsh-session-control)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![DeepSeek Harness](https://img.shields.io/badge/DSH-Plugin-blue.svg?style=flat-square)](https://goodandready.app)
+
+Продвинутое управление сессиями в боковой панели **DeepSeek Harness**: закрепление нужных диалогов, поиск по содержимому с фрагментом совпадения, чтение архивных разговоров в модальном окне, уборка шума и групповые действия над сессиями.
+
+---
+
+## Что плагин делает с панелью
+
+Плагин **заменяет тело боковой панели** — блок со списком рабочих папок и сессий. Остальная панель остаётся штатной: бренд, кнопка создания новой сессии, подвал и вход в настройки не затрагиваются.
+
+Замена необходима архитектурно: слот `sidebar.workspaces` объявлен ядром как `kind: "single"`, второго регистранта у него не бывает, а другого слота в теле панели нет.
+
+---
+
+## Сравнение со штатной панелью
+
+| Возможность | Штатная панель | С плагином `dsh-session-control` |
+|---|---|---|
+| **Закрепление диалогов** | ❌ Нет | ✅ Общая группа закреплённых сессий вверху панели |
+| **Раздел архива** | ❌ Не виден нигде | ✅ Отдельный раздел, разбитый по периодам |
+| **Чтение архивной сессии** | ❌ Невозможно | ✅ Окно расшифровки (только на чтение) |
+| **Результаты поиска** | ⚠️ Только заголовок строки | ✅ Заголовок + фрагмент текста с совпадением |
+| **Пустые сессии** | ⚠️ Вперемешку с рабочими | ✅ Скрыты автоматически (кроме текущей сессии) |
+| **Действия над пачкой строк** | ❌ Нет | ✅ Множественный выбор чекбоксами и диапазоны по Shift |
+| **Скрыть лишнее** | ❌ Только необратимый архив | ✅ Обратимое скрытие в один клик |
+| **Индикатор активной сессии** | ❌ Не показан | ✅ Пульсирующая точка активности в строке |
+| **Переименование по месту** | ⚠️ Модальный диалог | ✅ Двойной клик или клавиша F2 прямо в строке |
+
+> Штатные возможности — рабочие папки, поиск по содержимому диалогов, ответвление сессии — остаются на месте: плагин их переиспользует, а не переписывает.
+
+---
+
+## Установка
+
+Установка через CLI `dsh` для профиля `web`:
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-session-control
+```
+
+Перезапустите веб-профиль DeepSeek Harness для применения бандл-патча.
+
+---
+
+## Как вернуть штатную панель
+
+Чтобы в любой момент вернуть стандартную боковую панель:
+
+```bash
+dsh plugin --profile web remove @goodandready/dsh-session-control
+```
+
+Штатный ряд `ui-workspace` немедленно включается обратно, панель возвращается к исходному виду. Настройки закреплений и скрытий сохраняются на хосте и автоматически подхватятся при повторной установке плагина.
+
+---
+
+## Возможности
+
+### 📌 Закрепление сессий
+Нужные диалоги выносятся в отдельную группу сверху панели. Закрепления сохраняются при перезагрузке, смене браузера и переходе на другое устройство, так как настройки хранятся на хосте.
+
+### 🔍 Поиск с контекстным фрагментом
+Ядро ищет по содержимому диалогов и возвращает кусок текста вокруг совпадения — плагин выводит его второй строкой под заголовком, поэтому сразу видно причину совпадения без необходимости открывать сессию.
+
+### 🗄️ Архив по временным периодам
+Сессии архива разбиты на сворачиваемые группы: *Сегодня*, *На этой неделе*, *В этом месяце*, *Раньше*. Свёрнутый период не рендерится в DOM, что исключает лаги интерфейса при тысячах старых сессий. При активном поиске периоды с совпадениями раскрываются автоматически.
+
+### 📜 Расшифровка архивной сессии
+Заархивированную сессию нельзя открыть в режиме беседы (ядро снимает выбор с таких сессий). Плагин предоставляет изолированное модальное окно просмотра расшифровки через маршрут `GET /dsh-session-control/transcript?session=<id>` только на чтение.
+
+### 🧹 Скрытие пустых сессий
+Сессии без сообщений непрерывно генерируются шедулерами, мессенджерами и канбан-досками. Они автоматически скрываются, сохраняя чистоту панели. Текущая активная сессия не скрывается никогда. Поведение настраивается в карточке плагина.
+
+### 👁️ Обратимое скрытие
+Собственный механизм скрытия, в отличие от необратимого ядрового архива: скрытая сессия восстанавливается одним кликом.
+
+### ☑️ Множественный выбор и пакетные операции
+Выбор строк чекбоксами при наведении и выбор диапазона через Shift+Click. Над выбранными строками доступны групповое скрытие, закрепление и разархивация видимости.
+
+### ✏️ Быстрое переименование
+Переименование сессии по двойному клику на заголовок или по нажатию клавиши `F2`.
+
+---
+
+## Настройки
+
+Карточка расположена в: **Настройки → Плагины → Настройки плагинов → Управление сессиями** (`dsh-session-control`):
+
+| Поле | Тип | По умолчанию | Описание |
+|---|---|---|---|
+| `pinned` | `string[]` | `[]` | Идентификаторы закреплённых сессий (порядок в массиве задаёт порядок в панели) |
+| `hidden` | `string[]` | `[]` | Идентификаторы скрытых сессий |
+| `hideBlank` | `boolean` | `true` | Автоматически скрывать сессии без сообщений |
+
+Настройки хранятся на хосте и синхронизируются между всеми клиентами.
+
+---
+
+## Архитектурные ограничения
+
+* **Перенос диалога в другую рабочую папку не поддерживается:** Рабочая папка привязана к каталогу на диске, а принадлежность сессии выводится из её рабочего каталога (`cwd`). Реестр ядра строго отвергает несоответствие путей.
+* **Возврат из архива не предусмотрен:** В API ядра есть только архивация, метод возврата отсутствует. Архивная сессия доступна для безопасного чтения через расшифровку.
+* **Чтение устаревших журналов:** Часть архивных сессий раннего формата ядро не парсит; такие логи отображаются с информативным пояснением, а не с ложным «нет сообщений».
+* **Удаление сессий отсутствует:** Удаление не предусмотрено в публичном API ядра, и плагин строго соблюдает контракт безопасности.
+
+---
+
+## Архитектура и надежность
+
+Плагин спроектирован по **двухчастной архитектуре** для гарантии отказоустойчивости:
+
+1. **Сервисная половина (`uiWorkspace` провайдер):**
+   * Заменяемый модуль `ui-workspace` регистрирует обязательный сервис `uiWorkspace`, от которого зависят `dsh-client-ui-sidebar` и `dsh-client-ui-conversation`.
+   * Сервисная половина отдаёт сервис и корневые хуки без React-рендеринга и оверхеда.
+2. **Интерфейсная половина (UI):**
+   * Дерево рабочих пространств, поиск, модальное окно расшифровки и карточка настроек.
+   * Полностью изолирована предохранителями (Error Boundaries): сбой вёрстки не ломает панель и окно диалога.
+3. **Серверный маршрут:**
+   * `GET /dsh-session-control/transcript` безопасно парсит и отдаёт лог JSONL архивной сессии.
+
+---
+
+## Языки интерфейса
+
+Поставляется со строками на английском языке по умолчанию. Переводы (включая русский язык) подключаются через языковые пакеты (`@goodandready/dsh-russian-lang`).
+
+---
+
+## Совместимость
+
+- DeepSeek Harness `0.1.2-rc.1` и `0.1.3-alpha.1`.
+- Node.js `^20.19.0` или `>=22.12.0`.
+- Полная совместимость с `@goodandready/dsh-lanmode`, `@goodandready/dsh-kanban`, `@goodandready/dsh-cron` и другими плагинами DSH.
+
+---
+
+## Лицензия
+
+MIT © GoodAndReady

package/docs/README.zh.md

@@ -0,0 +1,146 @@
+# @goodandready/dsh-session-control
+
+[English](../README.md) | [Русский](README.ru.md) | [中文](README.zh.md)
+
+[![npm version](https://img.shields.io/npm/v/@goodandready/dsh-session-control.svg?style=flat-square)](https://www.npmjs.com/package/@goodandready/dsh-session-control)
+[![npm downloads](https://img.shields.io/npm/dm/@goodandready/dsh-session-control.svg?style=flat-square)](https://www.npmjs.com/package/@goodandready/dsh-session-control)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![DeepSeek Harness](https://img.shields.io/badge/DSH-Plugin-blue.svg?style=flat-square)](https://goodandready.app)
+
+**DeepSeek Harness** 侧边栏高级会话控制插件：置顶关键对话、带上下文匹配摘要的高级搜索、只读归档记录查看器、自动隐藏空白无用会话及多选批量操作。
+
+---
+
+## 插件对侧边栏的改造
+
+本插件**替换了侧边栏的主体内容**——即工作区与会话列表部分。侧边栏的其他原生部分完全保持原样：品牌标识、新建会话按钮、底部状态栏以及设置导航入口均不受影响。
+
+替换是架构上的必然要求：Harness 核心将 `sidebar.workspaces` 插槽声明为 `kind: "single"`，不允许注册多个并列组件，且侧边栏主体没有其他扩展插槽。
+
+---
+
+## 功能对比：原生侧边栏 vs dsh-session-control
+
+| 功能特性 | 原生侧边栏 | `dsh-session-control` |
+|---|---|---|
+| **会话置顶 (Pin)** | ❌ 无 | ✅ 顶部全局置顶区，统一管理 |
+| **归档视图 (Archive)** | ❌ 完全不可见 | ✅ 独立归档分区，按时间段折叠聚合 |
+| **阅读归档会话** | ❌ 无法打开 | ✅ 只读完整会话转录记录弹窗 |
+| **内容搜索结果** | ⚠️ 仅显示标题 | ✅ 标题 + 匹配内容上下文摘要预览 |
+| **空白会话** | ⚠️ 与活跃会话混杂 | ✅ 自动隐藏无消息会话（当前会话除外） |
+| **批量操作** | ❌ 无 | ✅ 复选框多选及 Shift+Click 范围批量操作 |
+| **可逆隐藏** | ❌ 仅支持不可逆归档 | ✅ 一键可逆隐藏与恢复 |
+| **活跃运行指示** | ❌ 无指示 | ✅ 实时运行脉冲状态圆点 |
+| **就地快速重命名** | ⚠️ 弹窗修改 | ✅ 双击标题或按 F2 直接在行内重命名 |
+
+> 原生 Harness 核心功能（工作区目录、深度会话搜索、会话分支等）完全保留：插件复用并强化了核心能力，而非重复造轮子。
+
+---
+
+## 安装方法
+
+通过 `dsh` CLI 为 web profile 安装：
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-session-control
+```
+
+重启 DeepSeek Harness web profile 以应用 bundle patch。
+
+---
+
+## 恢复原生侧边栏
+
+随时可以通过卸载命令恢复默认侧边栏：
+
+```bash
+dsh plugin --profile web remove @goodandready/dsh-session-control
+```
+
+原生 `ui-workspace` 模块将立即恢复启用，侧边栏恢复默认外观。所有置顶和隐藏配置安全保留在宿主存储中，重新安装插件后自动恢复。
+
+---
+
+## 核心功能
+
+### 📌 会话置顶 (Pinned Sessions)
+将高频核心对话置顶在侧边栏最上方的全局置顶区。由于配置存储在宿主端，置顶状态在页面刷新、更换浏览器或跨设备访问时均能持久保持。
+
+### 🔍 上下文片段搜索 (Search with Snippets)
+核心支持对话内容全文检索，`dsh-session-control` 在搜索结果中提取并展示匹配文本的上下文摘要行，无需打开会话即可快速确认匹配细节。
+
+### 🗄️ 按时间段归档聚合 (Period-Based Archive)
+归档会话按 *今天*、*本周*、*本月*、*更早* 进行分组折叠展示。折叠的时间段不会在 DOM 中渲染，即使存在数千个历史会话也不会造成界面卡顿。搜索时命中的时间段会自动展开。
+
+### 📜 只读归档转录查看器 (Archived Transcript Viewer)
+在核心中已归档的会话无法直接进入对话模式。插件通过独立服务端路由 `GET /dsh-session-control/transcript?session=<id>` 提供安全的只读转录弹窗，方便查阅历史对话与工具调用。
+
+### 🧹 自动隐藏空白会话 (Hide Blank Sessions)
+定时调度、消息网关及看板插件会持续创建无消息会话。插件默认自动隐藏空白会话，保持侧边栏整洁清爽。当前正在使用的会话即使为空也绝不会被隐藏。可在设置中自定义开启或关闭。
+
+### 👁️ 可逆隐藏 (Reversible Hiding)
+区别于核心单向的归档机制，插件提供轻量级的可逆隐藏功能，方便随时收起或恢复会话。
+
+### ☑️ 多选与批量操作 (Batch Operations)
+悬停复选框与 Shift 键区间连选，支持批量隐藏、批量取消隐藏及批量置顶。
+
+### ✏️ 就地快速重命名 (In-Place Rename)
+双击会话标题或按下 `F2` 快捷键即可直接在列表中重命名。
+
+---
+
+## 配置项
+
+前往 **设置 → 插件 → 插件设置 → 会话控制 (dsh-session-control)**：
+
+| 字段 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `pinned` | `string[]` | `[]` | 置顶会话 ID 列表（数组顺序决定展示顺序） |
+| `hidden` | `string[]` | `[]` | 可逆隐藏的会话 ID 列表 |
+| `hideBlank` | `boolean` | `true` | 是否自动隐藏无消息的空白会话 |
+
+所有设置均持久保存在宿主端并在所有客户端间同步。
+
+---
+
+## 设计约束说明
+
+* **不支持跨工作区移动会话：** 工作区与本地磁盘目录绑定，会话归属由其工作目录 (`cwd`) 决定，核心注册表严格校验路径一致性。
+* **不支持从归档恢复：** Harness 核心目前仅提供归档接口，未提供反归档 API。归档会话可通过转录查看器安全只读查阅。
+* **早期日志格式兼容：** 早期格式的历史日志若无法被核心反序列化，插件会展示清晰说明提示，避免错误显示为“无消息”。
+* **不支持物理硬删除：** 核心公共接口未开放硬删除方法，插件严格遵循安全规范。
+
+---
+
+## 架构与可靠性
+
+插件采用严谨的**双半区架构**设计以确保最高可靠性：
+
+1. **服务半区 (`uiWorkspace` 提供者):**
+   * 被替换的原生 `ui-workspace` 负责导出核心服务 `uiWorkspace`，该服务是 `dsh-client-ui-sidebar` 和 `dsh-client-ui-conversation` 的强依赖项。
+   * 插件的服务半区以零 React 渲染、零额外逻辑的极轻量方式提供该服务与根 Hooks。
+2. **界面半区 (UI & Views):**
+   * 包含工作区树、搜索列表、转录弹窗及设置卡片。
+   * 完全由错误边界 (Error Boundaries) 保护，即使 UI 发生异常也不会影响侧边栏其他部分及主聊天界面的正常运行。
+3. **服务端路由:**
+   * 提供 `GET /dsh-session-control/transcript` 路由，安全解析并流式读取归档 JSONL 日志。
+
+---
+
+## 语言与本地化
+
+插件核心内置英语文本。俄语及中文等多语言支持通过语言包扩展（如 `@goodandready/dsh-russian-lang`）。词典注册具备容错保护，不会因冲突引发异常。
+
+---
+
+## 兼容性
+
+- 经验证支持 DeepSeek Harness `0.1.2-rc.1` 与 `0.1.3-alpha.1`。
+- 支持 Node.js `^20.19.0` 或 `>=22.12.0`。
+- 与 `@goodandready/dsh-lanmode`、`@goodandready/dsh-kanban`、`@goodandready/dsh-cron` 等 DSH 插件无缝协同工作。
+
+---
+
+## 许可证
+
+MIT © GoodAndReady

package/docs/design/DESIGN.md

@@ -0,0 +1,231 @@
+# DESIGN.md — dsh-session-control
+
+Дизайн-контракт плагина. Источник истины о том, что видит пользователь и почему
+именно так. Дополняет спецификацию
+`docs/superpowers/specs/2026-09-05-dsh-session-control-design.md`: там — почему
+такая архитектура, здесь — как это выглядит и ведёт себя.
+
+## Product / Purpose
+
+- **Назначение:** управление сессиями DSH в боковой панели — закрепление нужных
+  диалогов, перенос между проектами, переименование по месту, обратимое
+  скрытие, доступ к ядровому архиву.
+- **Аудитория:** пользователь DSH, у которого накопилось больше диалогов, чем
+  помещается в голове: несколько проектов, десятки сессий, часть из них нужна
+  постоянно.
+- **Статус:** выпуск `0.1.0`, работает на production.
+
+## User Surfaces
+
+- **Web/UI:** тело боковой панели — слот `sidebar.workspaces`. Плагин заменяет
+  ядровый блок «Рабочие папки» целиком. Остальная панель (бренд, «Новая
+  сессия», подвал, настройки) остаётся ядровой и не затрагивается.
+- **DSH UI / settings / slots:**
+  - `sidebar.workspaces` (`single`/`root`) — наш список;
+  - `conversation.hero.workspace` (`single`/`root`) — выбор папки на пустом
+    экране беседы, обязательство замены;
+  - дочерние слоты `sidebar.workspaces.directoryFlow` и
+    `conversation.hero.workspace.directoryFlow` — объявляем, чтобы работал
+    выбор каталога;
+  - `settings.plugin.item` с ключом `dsh-session-control` — карточка настроек.
+- **API:** один собственный маршрут — `GET /dsh-session-control/transcript?session=<id>`,
+  расшифровка архивной сессии. Понадобился потому, что заархивированную сессию
+  нельзя открыть в беседе: окно истории у клиента поднимается только для сессии
+  «на сцене», а архивная текущей быть не может. Все остальные действия идут в
+  ядровые `session/rename`, `session/create`, `workspace/archiveSession`.
+- **CLI:** отсутствует.
+- **Документация:** `README.md` (установка, что заменяет, как вернуть штатную
+  панель), `CHANGELOG.md`, этот файл, спецификация.
+
+## Visual Direction
+
+- **Атмосфера:** неотличимо от ядра. Плагин занимает место штатного блока, и
+  пользователь не должен замечать подмену — ни по отступам, ни по шрифтам, ни по
+  поведению при наведении. Всё новое (закрепление, разделы) выглядит так, будто
+  всегда было частью DSH.
+- **Утверждённые референсы:** сама ядровая панель DSH — блок «Рабочие папки»,
+  строка сессии, меню `...`, карточки настроек «Консоль» и «Цикл агента».
+  Берём из них метрики, роли цветов, поведение раскрытия и вид меню.
+- **Не копировать:** чужие плагины-переписыватели боковой панели, их разметку,
+  классы и ассеты. Референс — принципы ядра, а не чей-либо готовый интерфейс.
+
+## Foundations
+
+### Цвета и роли
+
+Только переменные темы, ни одного литерального цвета. Набор снят с ядровых
+модулей панели, а не придуман:
+
+| Переменная | Роль у нас |
+|---|---|
+| `--dsw-alias-label-primary` | заголовок сессии, название папки |
+| `--dsw-alias-label-secondary` | возраст сессии, подписи разделов |
+| `--dsw-alias-label-tertiary` | значки, шеврон раскрытия |
+| `--dsw-alias-label-caption` | пояснения в пустых состояниях |
+| `--dsw-alias-interactive-bg-hover` | подсветка строки при наведении |
+| `--dsw-alias-state-business-primary` | активная сессия, индикатор `running` |
+| `--dsw-alias-state-error-primary` | ошибка операции в строке |
+| `--dsw-alias-border-l2`, `--dsw-alias-border-l4` | разделители, рамка карточки |
+| `--dsw-alias-bg-layer-3` | фон карточки настроек |
+| `--dsw-specific-sidebar-fill` | фон панели |
+| `--dsw-alias-scrollbar-bg-l2`, `--dsw-alias-scrollbar-hover-l2` | полоса прокрутки |
+| `--ds-ease-in-out` | все переходы |
+
+### Отступы и метрики
+
+Горизонтальный отступ берём у ядра — его задаёт `@deepseek-ai/dsh-client-ui-sidebar`,
+который остаётся на месте:
+
+```css
+padding-inline: var(--dsh-sidebar-inline-padding);
+```
+
+Это единственный способ совпасть по вертикали с кнопкой «Новая сессия» над нами.
+Своё число здесь — гарантированный рассинхрон при любой правке ядра.
+
+Метрики списка `--dsh-session-list-edge-inset`,
+`--dsh-session-list-scrollbar-offset`, `--dsh-session-list-scrollbar-width`
+задавал заменяемый модуль, поэтому вместе с ним они исчезнут. Объявляем свои
+под тем же смыслом и с теми же значениями, с префиксом `--dsc-`.
+
+### Типографика
+
+Наследуем от документа. Заголовок сессии — обычный вес, размер как в ядровой
+строке; возраст — на ступень мельче и вторичным цветом. Своих шрифтов и
+`font-family` не вводим, кроме `--ds-font-family-code`, если понадобится
+показать идентификатор.
+
+### Классы
+
+Префикс `dsc-` у каждого класса без исключений. Стили живут в общем документе
+рядом с чужими; класс без префикса однажды перекрасит чужую разметку, и искать
+причину будут долго.
+
+### Accessibility
+
+- Заголовки разделов — `button` с `aria-expanded`, не `div` с обработчиком.
+- Список сессий — навигация с клавиатуры: стрелки, Enter открывает, F2
+  переименовывает, Escape отменяет.
+- Меню `...` открывается с клавиатуры и закрывается по Escape с возвратом
+  фокуса на кнопку.
+- Индикатор `running` дублируется текстом для чтения с экрана, а не только
+  цветом.
+- Переименование по месту — обычное поле с меткой, а не `contenteditable`.
+
+## Components And States
+
+### Компоненты
+
+| Компонент | Назначение |
+|---|---|
+| `SessionList` | корень блока: поиск, разделы, прокрутка |
+| `PinnedGroup` | закреплённые, плоско, в порядке закрепления |
+| `WorkspaceGroup` | папка и её сессии |
+| `SessionRow` | строка: заголовок, возраст, индикатор, меню |
+| `RowMenu` | закрепить/открепить, переименовать, ответвить, скрыть, архив |
+| `CollapsedSection` | «Скрытые», «Архив» и периоды внутри архива |
+| `ArchiveViewer` | расшифровка архивной сессии, только чтение |
+| `HeroWorkspacePicker` | выбор папки на пустом экране беседы |
+| `SettingsCard` | карточка в «Настройки → Плагины» |
+
+### Состояния
+
+| Состояние | Что показываем |
+|---|---|
+| `loading` | скелет из трёх строк, без текста «Загрузка» |
+| `empty` — нет папок | приглашение создать первую папку с кнопкой |
+| `empty` — папка пуста | одна строка пояснения внутри папки |
+| `empty` — поиск без результата | «Ничего не найдено» и подсказка искать по содержимому |
+| `error` — операция не удалась | сообщение в самой строке цветом ошибки, действие не откатывается молча |
+| `error` — настройки недоступны | закрепление и скрытие отключены, панель работает как обычный список; причина написана |
+| `unreadable` — журнал раннего формата | расшифровка объясняет, что ядро отказывается читать, а не сообщает о пустоте |
+| `success` | без всплывающих уведомлений: результат виден в самом списке |
+
+**Статус снимка настроек важнее значения.** При `unavailable` карточка не рисует
+пустую форму, которая с виду работает: она пишет, что пространство настроек
+хосту неизвестно. Проверяем статус, а не значение.
+
+### Формы, валидация и действия
+
+- **Переименование:** двойной клик по заголовку → поле в строке. Enter
+  сохраняет, Escape отменяет, потеря фокуса сохраняет. Пустое имя не
+  сохраняется, строка остаётся в правке.
+- **Скрытие:** обратимо, наше. Возврат — из раздела «Скрытые».
+- **Архив:** пункт меню ведёт в ядровый архив и **необратим**. Спрашиваем
+  подтверждение и прямо пишем, что вернуть нельзя. Это единственное действие
+  плагина с подтверждением.
+
+## User Flows
+
+1. **Закрепить нужное.** Меню строки → «Закрепить». Сессия уходит в группу
+   сверху. Переживает перезагрузку, другой браузер и другое устройство.
+2. **Найти старое.** Поиск в шапке блока: по заголовкам и по содержимому
+   диалогов. Результат — плоский список со сниппетами.
+4. **Убрать лишнее, не потеряв.** Меню → «Скрыть». Раздел «Скрытые» внизу,
+   возврат одним нажатием.
+5. **Назвать понятно.** Двойной клик по заголовку, правка на месте.
+6. **Начать работу в проекте.** Кнопка «Новая сессия» ядра и выбор папки на
+   пустом экране беседы продолжают работать — это обязательства замены, а не
+   наша функциональность.
+
+## Do / Don't
+
+**Do**
+
+- Брать горизонтальные отступы из `--dsh-sidebar-inline-padding`.
+- Регистрировать в слоты только через `ctx.slots.inject(name, cb)`.
+- Показывать отказ операции в интерфейсе, а не в консоли.
+- Держать половину «сервис» без React и без нашей логики.
+- Проверять статус снимка настроек перед отрисовкой формы.
+
+**Don't**
+
+- Не искать чужие узлы через `querySelector` и не клонировать ядровые кнопки:
+  это ровно тот способ, который у нас уже ломается в других плагинах.
+- Не заводить свой раздел в боковом списке настроек — только карточка.
+- Не использовать литеральные цвета и свои значения отступов панели.
+- Не строить скрытие поверх ядрового архива: он необратим.
+- Не предлагать перенос диалога между папками: модель этого не допускает.
+- Не показывать всплывающих уведомлений об успехе.
+- Не разворачивать разделы «Скрытые» и «Архив» по умолчанию.
+
+## Locked Design Decisions
+
+- **2026-09-05 — заменяем блок, а не дополняем.** Слот `sidebar.workspaces`
+  объявлен ядром как `kind: "single"`, второго регистранта не бывает, другого
+  слота в теле панели нет. Пересмотр — если ядро объявит слот списочным или
+  добавит точки расширения внутри списка.
+- **2026-09-05 — две независимые половины.** Сервис `uiWorkspace` стоит в
+  обязательном `inject` у `dsh-client-ui-sidebar` и `dsh-client-ui-conversation`,
+  поэтому отказ нашей вёрстки не должен уносить приложение. Пересмотр — если
+  ядро перестанет требовать этот сервис.
+- **2026-09-05 — закрепление общее на всю панель,** не внутри папки. Решение
+  владельца. Пересмотр — если папок станет столько, что закреплённые начнут
+  смешивать проекты.
+- **2026-09-05 — своё скрытие вместо ядрового архива.**
+  `WorkspaceRegistry.archiveSession` только добавляет, метода возврата в API нет,
+  раздела архива в интерфейсе нет вовсе. Пересмотр — если ядро добавит возврат.
+- **2026-09-05 — настройки карточкой `settings.plugin.item`,** без своего
+  раздела. Пересмотр — только по явной просьбе владельца.
+- **2026-09-05 — переноса между папками не будет.** Рабочая папка — это каталог на хосте, а членство сессии выводится из её рабочего каталога: `attachSession` в реестре отвергает сессию, чей `cwd` не совпадает с путём папки. Перенести диалог в другую папку нельзя ни из клиента, ни из серверной половины — это не пробел в API, а устройство модели. Именно поэтому такого пункта нет и в ядровой панели.
+  Пересмотр — только если ядро перестанет выводить членство из рабочего
+  каталога. Обнаружено проверкой на песочнице: пункт меню возвращал
+  `workspace/move-invalid: the session is not accounted`.
+- **2026-09-07 — расшифровку архива готовит серверная половина.** Со стороны
+  браузера архив не читается: `session/follow` требует потокового переносчика,
+  `session/page` отвечает «failed to observe session», а окно истории
+  поднимается только для текущей сессии. Запертое решение «своих маршрутов нет»
+  снято осознанно и только для чтения. Пересмотр — если ядро откроет чтение
+  чужого журнала с клиента.
+- **2026-09-07 — плагин везёт только английский.** Переводы поставляет
+  отдельный языковой плагин и занимает то же пространство настроек раньше нас.
+  Собственный русский словарь ронял регистрацию, а вместе с ней всю половину
+  «интерфейс». Регистрация словаря защищена отдельно от остального.
+- **2026-09-07 — текущая сессия не прячется никогда,** даже пустая. Иначе
+  исчезает строка, в которую человек как раз собирается писать.
+- **2026-09-07 — архив разбит по календарным периодам,** а не по «минус
+  столько-то часов»: человек мыслит «сегодня» и «на этой неделе». Свёрнутый
+  период не рисуется — это же снимает вопрос отрисовки сотен строк.
+- **2026-09-05 — автоназвание диалогов вне рамок первой версии.** Требует
+  вызовов модели и денег; переименование по месту закрывает ту же боль даром.
+  Пересмотр — после обкатки, отдельной задачей.

package/docs/superpowers/specs/2026-09-05-dsh-session-control-design.md

@@ -0,0 +1,250 @@
+# dsh-session-control — дизайн
+
+- Пакет: `@goodandready/dsh-session-control`
+- Дата: 2026-09-05
+- Ядро, под которое проектируем: DSH `0.1.2-rc.1`
+- Статус: дизайн согласован, реализация не начата
+
+## Задача
+
+Дать управление сессиями в боковой панели: закреплять нужные диалоги, переносить
+их между проектами, переименовывать по месту, находить старое и убирать лишнее
+обратимо.
+
+## Что уже умеет ядро
+
+Проверено на живом production 2026-09-05, чтение без изменений.
+
+| Возможность | Состояние |
+|---|---|
+| Проекты | Есть — «Рабочие папки» (workspaces): создание, переименование, удаление |
+| Переименование сессии | Есть — пункт меню и `session/rename` |
+| Полнотекстовый поиск по истории | Есть и работает — `session/search` возвращает сниппеты из тела диалогов |
+| Порядок сессий внутри папки | API есть — `workspace/insertSessionBefore`. **Внимание:** это только порядок внутри папки; вызов с чужим `workspaceId` отвергается |
+| Признак «сессия работает» | Есть в данных — `SessionSummary.running`. Не показывается |
+
+Это мы не переписываем, а переиспользуем.
+
+## Чего нет
+
+1. **Закрепление.** Ни метода, ни поля, ни признака нигде в API и в UI.
+3. **Обзор без поиска.** Сессии видны только внутри раскрытой папки. Общего
+   списка нет.
+4. **Возврат из архива.** Архив односторонний, см. ниже.
+
+### Архив ядра необратим
+
+`WorkspaceRegistry.archiveSession` только добавляет:
+
+```js
+archiveSession(sessionId) {
+  if (this.requireState().archivedSessionIds.includes(sessionId)) return;
+  ...archivedSessionIds: [...state.archivedSessionIds, sessionId]
+}
+```
+
+Метода «вернуть» в API нет. Плюс во всём модуле панели про архив есть ровно одна
+строка — пункт меню `menu.archiveSession`; раздела с архивом не существует.
+Сессия исчезает из интерфейса навсегда, хотя сама цела.
+
+Поэтому наше «скрыть» строим отдельно и обратимо, а ядровый архив показываем
+как отдельный раздел только на чтение.
+
+## Ключевое ограничение: блок несущий
+
+Тело боковой панели — единственный слот, и он не допускает второго регистранта.
+Контракт `@deepseek-ai/dsh-client-ui-sidebar`:
+
+```js
+"sidebar.workspaces":    { kind: "single", scope: "root" },
+"sidebar.settings":      { kind: "single", scope: "root" },
+"sidebar.footer.action": { kind: "list",   scope: "root" },
+```
+
+`single` — значит «дополнить» нельзя, только заменить. А чтобы занять слот,
+нужно освободить его, то есть выключить ядровый ряд `ui-workspace`.
+
+Но тот же модуль отдаёт служебный сервис `uiWorkspace`, и он стоит в
+**обязательном** `inject` у ядровых модулей:
+
+```js
+// dsh-client-ui-sidebar
+const inject = ["slots", "layout", "uiWorkspace", "locale"]
+// dsh-client-ui-conversation
+const inject = ["slots", "sessions", "uiSession", "uiWorkspace", "locale", "settingsScope"]
+```
+
+Плюс он нужен `ui-agent-preset` и `ui-directory-picker-browse`. Просто выключить
+`ui-workspace` нельзя: пропадёт `uiWorkspace`, и не поднимутся ни панель, ни
+интерфейс беседы — экран будет пустой.
+
+Значит, заменяя блок, мы обязаны отдать всё, что модуль отдавал.
+
+## Пять обязательств замены
+
+1. **`sidebar.workspaces`** — наш список. Ради этого всё.
+2. **Сервис `uiWorkspace`** — около 120 строк, шесть методов
+   (`connectWorkspace`, `startSession`, `archiveSession`, `pickDirectory`,
+   `listDirectory`, `createDirectory`) плюс слежение за навигацией. Всё поверх
+   публичных `workspace/*`, `session/*` и `remote.directoryPicker`.
+3. **Дочерние слоты** `sidebar.workspaces.directoryFlow` и
+   `conversation.hero.workspace.directoryFlow`, оба `single`/`root`. Без них
+   отвалится выбор каталога при создании папки.
+4. **`conversation.hero.workspace`** — выбор папки на пустом экране беседы.
+5. **Корневой хук** `ctx.slots.provideRoot({ hooks: { workspaces: workspaces.list } })` —
+   им пользуются чужие компоненты, воспроизвести как есть.
+
+Объём при этом не «переписать модуль»: 125 КБ ядрового модуля — это React-вёрстка,
+которую мы и так заменяем осознанно. Служебная часть небольшая и механическая.
+
+## Устройство: две независимые половины
+
+Плагин становится несущим, поэтому он обязан быть устроен так, чтобы его
+поломка не гасила приложение. Один пакет, две половины, регистрируются
+раздельно.
+
+### Половина «сервис»
+
+Только сервис `uiWorkspace`, объявления дочерних слотов и корневой хук. Без
+React, без нашей логики, без настроек, без сети сверх ядровых вызовов. Её
+единственная задача — никогда не падать. Пишется и проверяется первой.
+
+Инъекции повторяют ядровые:
+
+```js
+inject = ["slots", "sessions", "workspaces", "locale", "remote", "remote.directoryPicker"]
+```
+
+### Половина «интерфейс»
+
+Наш список: закрепление, перенос, скрытие, переименование по месту, поиск,
+группировка. Регистрируется отдельно и целиком в `try/catch`.
+
+**Смысл разделения:** если интерфейс сломается, слот `sidebar.workspaces`
+останется пустым, но сервис жив — панель, настройки и беседа работают. Будь это
+одна половина, любая опечатка в нашей вёрстке гасила бы весь DSH.
+
+## Панель
+
+Сверху вниз:
+
+1. **Поиск** — то же поле, тот же `sessions.search(query, signal)` по содержимому.
+2. **Закреплённые** — плоская группа, без папок, в порядке закрепления.
+   Закрепление общее на всю панель, не внутри папки.
+3. **Папки** — как сейчас: папка, внутри её сессии.
+4. **Скрытые** — свёрнутый раздел, наше, возврат одним нажатием.
+5. **Архив** — свёрнутый раздел, показываем только если непустой. Открыть
+   можно, вернуть нельзя; подписать честно.
+
+**Строка сессии:** заголовок, справа возраст, точка-индикатор при
+`SessionSummary.running`, при наведении — `...`.
+
+**Меню строки:** Закрепить / Открепить · Переименовать · Ответвить · Скрыть ·
+В архив.
+
+**Переноса между папками не будет.** Рабочая папка — это каталог на хосте, а членство сессии выводится из её
+рабочего каталога: `attachSession` в реестре отвергает сессию, чей `cwd` не
+совпадает с путём папки. Перенести диалог в другую папку нельзя ни из клиента,
+ни из серверной половины — это не пробел в API, а устройство модели. Именно
+поэтому такого пункта нет и в ядровой панели.
+
+**Переименование:** двойной клик по заголовку, поле прямо в строке, без диалога.
+
+**Настройки плагина:** карточка в «Настройки → Плагины → Настройки плагинов»
+через слот `settings.plugin.item`, ключ карточки равен имени пространства
+настроек. Своего раздела в боковом списке не заводим.
+
+## Данные
+
+Пространство настроек `dsh-session-control`, два поля:
+
+| Поле | Тип | Смысл |
+|---|---|---|
+| `pinned` | `string[]` | sessionId закреплённых, порядок массива = порядок в панели |
+| `hidden` | `string[]` | sessionId скрытых |
+
+Состояние «свёрнуто/развёрнуто» в настройках не храним: это видовое состояние
+одного браузера, и у ядра для него есть свой механизм (`createWorkspaceViewStore`).
+Гонять его через серверные настройки незачем.
+
+Настройки DSH серверные, поэтому закрепления переживают перезагрузку, смену
+браузера и устройство. Своего хранилища не заводим.
+
+Ссылка на исчезнувшую сессию — не ошибка: при отрисовке просто пропускаем
+sessionId, которого нет в списке, и вычищаем при следующей записи.
+
+## Потоки
+
+Читаем те же источники, что ядровый модуль: `ctx.get("sessions")` и
+`ctx.get("workspaces")` — их сторы дают список сессий, список папок и
+`archivedSessionIds`. Свои поля читаем из настроек.
+
+Порядок отрисовки: закреплённые вычитаем из папок, чтобы сессия не появлялась
+дважды. Скрытые вычитаем отовсюду, кроме своего раздела.
+
+Мутации идут прямо в ядровые методы: `session/rename`,
+`workspace/insertSessionBefore`, `session/create`. Своих серверных маршрутов
+плагин не добавляет — серверная половина нужна только чтобы объявить
+пространство настроек.
+
+## Обработка отказов
+
+- Любая регистрация в слот — через `ctx.slots.inject(name, cb)`, чтобы имя,
+  которого нет, было безвредным.
+- Регистрация локали — однократная, с учётом того, что клиентское дерево
+  применяется дважды за загрузку. Повторный `apply` не должен ни бросать, ни
+  дублировать эффекты.
+- Отказ любого ядрового вызова показываем в строке, а не проглатываем: молчащий
+  `catch` уже дал нам два невидимых дефекта в других плагинах.
+- Аварийный выход: `dsh plugin remove` возвращает ядровый ряд `ui-workspace` и
+  штатную панель.
+
+## Чего не делаем
+
+- **Автоназвание диалогов.** Требует вызова модели, денег и отдельного
+  обсуждения. Переименование по месту закрывает боль дешевле.
+- **Отдельный режим «все диалоги по датам».** Папки уже группируют, поиск
+  работает. Вводить, только если после обкатки окажется мало.
+- **Множественное выделение, экспорт, теги, цвета.** Не просили.
+- **Свой раздел в боковом списке настроек.** Карточка.
+
+## Проверки
+
+Тестового контура нет, функциональная проверка только на production после
+merge проверенного `main` и явного «ок» на deploy.
+
+Обязательный набор, каждый пункт с доказательством в issue:
+
+1. Панель рисуется, папки и сессии на месте.
+2. Закрепление: закрепить, перезагрузить страницу, открыть в другом браузере —
+   осталось.
+3. Перенос сессии в другую папку, порядок сохраняется после перезагрузки.
+4. Скрыть и вернуть.
+5. Переименование по двойному клику.
+6. Поиск по содержимому находит старый диалог.
+7. Создание папки с выбором каталога — проверяет обязательство №3.
+8. Пустой экран беседы: выбор папки на месте — обязательство №4.
+9. «Новая сессия» работает — обязательство №2.
+10. Открытие беседы, отправка сообщения — интерфейс беседы жив.
+11. Консоль при загрузке чистая, `Failed to load plugins` нет.
+
+Пункты 7–10 — не формальность: это ровно то, что ломается при неполной замене.
+
+## Порядок работ
+
+1. Gitea-репозиторий, каркас, `cordis.patch.yml`, обезличенность с первого
+   коммита.
+2. Половина «сервис» + проверка, что панель и беседа живы при выключенном
+   ядровом ряде и пустом слоте.
+3. Половина «интерфейс»: список, папки, поиск.
+4. Закрепление.
+5. Перенос между папками.
+6. Скрытие и раздел архива.
+7. Переименование по месту.
+8. Карточка настроек, README, документация.
+9. Production-проверка по списку выше.
+
+Доставка на прод до публикации: тарбол собирается из смерженного проверенного
+`main` и кладётся в `~/.cache/dsh-artifacts/`. Ссылка в рабочий каталог DEV
+недопустима ни на каком этапе. После публикации профиль переводится на обычную
+версию из registry.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-session-control",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Session management for the DeepSeek Harness sidebar: pin conversations, search their contents, read archived transcripts and hide the noise",
   "license": "MIT",
   "type": "module",
@@ -14,6 +14,7 @@
     "lib/",
     "cordis.patch.yml",
     "README.md",
+    "docs/",
     "CHANGELOG.md",
     "LICENSE"
   ],