@goodandready/dsh-session-control 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/),
+версии — [SemVer](https://semver.org/lang/ru/).
+
+## [0.1.0] — 2026-09-07
+
+Первый выпуск.
+
+### Added
+
+- Список сессий в боковой панели взамен штатного блока рабочих папок: папки,
+  сессии, поиск, свёртка, режим узкой панели, создание рабочей папки с выбором
+  каталога.
+- Закрепление диалогов, общее на всю панель; порядок задаётся вручную.
+- Обратимое скрытие — в отличие от ядрового архива, который необратим.
+- Раздел архива, которого в штатной панели нет вовсе, разбитый по периодам:
+  сегодня, на этой неделе, в этом месяце, раньше. Свёрнутый период не рисуется.
+- Расшифровка архивной сессии, только на чтение: маршрут
+  `GET /dsh-session-control/transcript?session=<id>` и окно просмотра.
+- Фрагмент с совпадением в результатах поиска по содержимому.
+- Скрытие сессий без сообщений, кроме текущей; переключается в настройках.
+- Множественный выбор строк с диапазоном по Shift и групповыми действиями.
+- Переименование по двойному клику или F2 прямо в строке.
+- Индикатор работающей сессии в строке.
+- Карточка настроек в «Настройки → Плагины».
+
+### Notes
+
+- Плагин заменяет тело боковой панели и отдаёт вместо ядрового модуля служебный
+  сервис `uiWorkspace`, от которого зависят модули панели и беседы. Половина
+  «сервис» отделена от половины «интерфейс», чтобы отказ вёрстки не гасил
+  приложение.
+- Переноса диалога между рабочими папками нет и не будет: членство выводится из
+  рабочего каталога сессии, а не хранится меткой.
+- Возврата из архива нет: ядро умеет только помещать в архив.
+- Часть архивных журналов раннего формата ядро читать отказывается; такие
+  сессии показываются с пояснением, а не с ложным «нет сообщений».
+- Интерфейс только на английском; переводы поставляет отдельный языковой
+  плагин.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GooDAnDReaDY
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,147 @@
+# @goodandready/dsh-session-control
+
+Управление сессиями в боковой панели DeepSeek Harness: закрепление нужных
+диалогов, поиск по содержимому, чтение архивных разговоров и уборка шума.
+
+## Что плагин делает с панелью
+
+Плагин **заменяет тело боковой панели** — блок со списком рабочих папок.
+Остальная панель остаётся штатной: бренд, кнопка новой сессии, подвал и вход в
+настройки не затрагиваются.
+
+Заменяет, а не дополняет, вынужденно: слот `sidebar.workspaces` объявлен ядром
+как `kind: "single"`, второго регистранта у него не бывает, а другого слота в
+теле панели нет.
+
+## Чем отличается от штатной панели
+
+| | Штатная панель | С плагином |
+|---|---|---|
+| Закрепление диалогов | нет | есть, общее на всю панель |
+| Архив | не виден нигде | отдельный раздел, разбитый по периодам |
+| Чтение архивной сессии | невозможно | расшифровка только на чтение |
+| Результаты поиска | только заголовок строки | плюс фрагмент с совпадением |
+| Пустые сессии | вперемешку с рабочими | скрыты, кроме текущей |
+| Действия над пачкой строк | нет | выбор галочками, Shift для диапазона |
+| Скрыть лишнее | только архив, необратимо | обратимое скрытие |
+| Индикатор работающей сессии | не показан | точка в строке |
+| Переименование | диалогом | по двойному клику в строке |
+
+Штатные возможности — рабочие папки, поиск по содержимому диалогов, ответвление
+сессии — остаются на месте: плагин их переиспользует, а не переписывает.
+
+## Установка
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-session-control
+```
+
+## Как вернуть штатную панель
+
+```bash
+dsh plugin --profile web remove @goodandready/dsh-session-control
+```
+
+Штатный ряд `ui-workspace` включается обратно, панель возвращается к исходному
+виду. Закрепления и скрытия остаются в настройках и подхватятся, если плагин
+поставить снова.
+
+## Возможности
+
+**Закрепление.** Нужные диалоги отдельной группой сверху, общей на всю панель.
+Переживают перезагрузку, смену браузера и устройство: настройки хранятся на
+хосте.
+
+**Поиск с фрагментом.** Ядро ищет по содержимому диалогов и возвращает кусок
+текста вокруг совпадения — плагин показывает его второй строкой, поэтому видно,
+чем именно нашлась строка, без открытия сессии.
+
+**Архив по периодам.** Сегодня, на этой неделе, в этом месяце, раньше.
+Свёрнутый период не рисуется вовсе, поэтому сотни архивных строк не попадают в
+разметку разом. При активном поиске периоды раскрываются, чтобы совпадения не
+прятались за свёрнутым заголовком.
+
+**Расшифровка архивной сессии.** Заархивированную сессию нельзя открыть в
+беседе — ядро снимает выбор с такой сессии. Плагин показывает её содержимое
+отдельным окном, только на чтение.
+
+**Скрытие пустых.** Сессии без единого сообщения непрерывно создают расписания,
+мессенджеры и доски. Они не показываются; текущая сессия не прячется никогда,
+даже пустая. Переключатель в карточке настроек возвращает прежнее поведение.
+
+**Обратимое скрытие.** Своё, в отличие от ядрового архива: скрытое возвращается
+одним нажатием.
+
+**Множественный выбор.** Галочка при наведении, Shift берёт диапазон. Над
+выбранным доступны скрытие, возврат и закрепление.
+
+**Переименование по месту.** Двойной клик по заголовку или F2.
+
+## Настройки
+
+Карточка в «Настройки → Плагины → Настройки плагинов». Пространство настроек —
+`dsh-session-control`:
+
+| Поле | Смысл |
+|---|---|
+| `pinned` | закреплённые сессии, порядок массива = порядок в панели |
+| `hidden` | скрытые сессии |
+| `hideBlank` | прятать сессии без сообщений (по умолчанию да) |
+
+Настройки хранятся на хосте, поэтому переживают смену браузера и устройство.
+
+## Чего плагин не умеет
+
+**Переносить диалог в другую рабочую папку.** Рабочая папка — это каталог, а
+членство сессии выводится из её рабочего каталога: реестр отвергает сессию, чей
+`cwd` не совпадает с путём папки. Это не пробел в API, а устройство модели, и
+поэтому такого пункта нет и в штатной панели.
+
+**Возвращать из архива.** Ядро умеет только помещать в архив; метода возврата в
+API нет. Архивная сессия доступна на чтение, но вернуть её в папку нельзя.
+
+**Читать очень старые журналы.** Часть архивных сессий хранится в раннем
+формате, который ядро отказывается читать. Такие показываются с пояснением, а
+не с ложным «нет сообщений».
+
+**Удалять сессии.** Удаления нет ни в одном публичном интерфейсе ядра, и плагин
+его не изобретает.
+
+## Устройство
+
+Плагин собран из двух независимых половин, и это требование безопасности, а не
+украшение архитектуры.
+
+Заменяемый ядровый модуль попутно отдаёт служебный сервис `uiWorkspace`,
+который стоит в обязательных зависимостях у модулей боковой панели и интерфейса
+беседы. Если его не отдать, приложение не поднимется вовсе.
+
+- **Половина «сервис»** отдаёт `uiWorkspace` и корневой хук списка папок. Без
+  React, без логики плагина, без настроек.
+- **Половина «интерфейс»** — список, расшифровка, карточка настроек. Целиком в
+  защитной обёртке.
+
+Отказ интерфейса оставляет тело панели пустым, но панель, настройки и беседа
+продолжают работать.
+
+Серверная половина добавляет один маршрут — расшифровку архивной сессии. Все
+остальные действия идут через штатные вызовы ядра.
+
+## Язык интерфейса
+
+Плагин везёт только английский. Переводы поставляются отдельным языковым
+плагином; регистрация словаря защищена и не может уронить панель, если
+пространство уже занято.
+
+## Совместимость
+
+Проверен на ядрах `0.1.2-rc.1` и `0.1.3-alpha.1`. Плагин опирается на контракт
+слотов боковой панели и на поверхность сервиса `uiWorkspace`; при смене этого
+контракта потребуется правка.
+
+Поверхность хранилища сессий у разных выпусков ядра различается, поэтому плагин
+спрашивает бэкенд, какие методы у него есть, а не полагается на номер версии.
+
+## Лицензия
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,21 @@
+# Слой dsh-session-control: применяется автоматически, когда пакет установлен
+# как bundle профиля (package.json объявляет dsh.bundle.patch).
+#
+# Плагин занимает тело боковой панели — слот sidebar.workspaces. Слот объявлен
+# ядром как kind: "single", второго регистранта не бывает, поэтому штатный ряд
+# приходится освободить.
+#
+# Ряд ui-workspace попутно отдавал служебный сервис uiWorkspace, который стоит в
+# ОБЯЗАТЕЛЬНОМ inject у dsh-client-ui-sidebar и dsh-client-ui-conversation.
+# Наша половина «сервис» отдаёт его вместо ядровой; без неё не поднимутся ни
+# панель, ни интерфейс беседы.
+#
+# Аварийный выход: dsh plugin remove @goodandready/dsh-session-control —
+# ряд ui-workspace снова включается и возвращается штатная панель.
+- id: ui-workspace
+  disabled: true
+
+- insert:
+    - id: dsh-session-control
+      name: '@goodandready/dsh-session-control'
+      config: {}